Skip to content
Gitweazle edited this page Jun 26, 2013 · 17 revisions

Before you can start playing all your favorite games you will need to go through a couple of steps. Below is a checklist of things you need to prepare or do in order to get MAMEHub running. The supported platforms are currently Windows, Mac and Linux.

Step 1 - The Prerequisites


  • First of all make sure you forward port 6805 for both TCP and UDP on your router and allow full access to zsync.exe, Updater.exe, CSUME.exe and MAMEHubClientt.exe in your personal firewall. (Windows Firewall is automatically configured when installing MAMEhub). The following video explains all you need to know about the HOWs and WHYs of port forwarding: Ports

  • MAMEHub v2 requires Java 1.7 or up to function properly. Having traces of older versions or running multiple versions of Java can sometimes cause glitches, so unless you know what you are doing, your safest bet is to first uninstall Java completely (for Windows users: Control Panel - Add or Remove Programs then use Search to find and remove folders named Sun or Java in your Documents & Settings folder) and reinstall the latest release from the official site: Java

  • Now you are ready to download and install MAMEHub. Go to http://www.mamehub.info/download and install the version that applies to you. This page also contains a detailed guide on how to proceed. If you need additional help or information, feel free to post in the official forum's Help section. (Do not ask for games or links to games on the forum).

Step 2 - Play Your First Game


  • To run a game you need a couple of things. The game itself, usually called a ROM and sometimes you also need a file that emulates the system BIOS. Both files must remain ZIP-ed and placed inside MAMEHub's roms folder. Most arcade games do not require a BIOS (except NEOGEO, PGM, NAOMI etc.), neither do the NES, TurboGrafx-16 (P Engine) or Sega Genesis (Mega Drive). Games that are run from a CD-ROM (PlayStation, Nintendo64, Genesis SegaCD, etc.) or hard drive, such as the arcade version of Killer Instinct, require an additional Compressed Hard Drive(CHD) image file.

  • After you collected all your favorite games start up MAMEHub. In order to get your game to show up in the list of games you need to audit or verify it. You do this by going into the Audit menu-item and selecting Rescan Folders. This can take several minutes, depending on how many games you have and how fast your computer is. Here you will also see the option to select additional folders for MAMEHub to look for game ROMs. This is useful if you have a lot of games, so you can manually sort them according to genre or system.

  • You are now ready to start or join a game. Joining an already open game is as simple as clicking Click to Join in the top-left section of MAMEHub's window. To start your own game, double click on the game you wish to play. You can sort your list by clicking on the respective column header or by inputting (a part of) the name at Search For Game. If you join a game that you do not have in your collection MAMEHub will attempt to download it from the host. You can view your downloads by clicking on the Download tab next to Games.

  • Once inside the game there are several commands you can use to configure the game or interact with other players. These can be found in the section In-game-commands of this Wiki.

Step 3 - Troubleshooting


  • WIP
  1. Why does my game not start? (turn on log etc/ missing files in ROM/ missing BIOS)
  2. What is desyncing and what can I do to prevent this? (no savestates, try other platform, same settings, wait before joining, dont reset/restart when other people are connected, dipswitches)
  3. Why can't I join somebody's game? (check if you can start it yourself else 1., ports)
  4. I don't have a CHD file, now what? / How do I run CDROM games? (chdman)
  5. What can I do to improve the in-game input lag/choppiness? (priority, command-line, check pings ~200ms)
  6. Why does my game not show up in the list? (d/l different version, filelist, missing files)
  7. ...more...????
Clone this wiki locally