Add and Manipulate a MAME Frontend

MAME is wonderfully simple ( [Hack #10] ); it’s a nice, unified bundle of myriad emulators you’d otherwise have to download and configure individually. While launching it from the command line and typing the name of the ROM you want to run is sufficient, adding in options can make things a little more complex.

There’s a dizzying array of frontend programs that bolt onto MAME. These provide sophisticated GUI-based menus with which the player can choose particular games to play and options to use. Some frontends also include handy game paraphernalia such as screenshots, cabinet photos, and even related audio and video, giving you a luxurious overview of your game before you even start the emulator.

With multiple platforms and myriad slightly different choices, where do you even start? My top choice of frontends is AdvanceMenu, though I’ll also outline some alternatives.


The AdvanceMenu ( site describes the program as “a frontend for AdvanceMAME, MAME, MESS, RAINE and any other emulator . . . .” It uses the cross-platform SDL multimedia library (, so it runs on Linux, Mac OS X, DOS, Windows, and a few other platforms. Because it’s from the same team that developed AdvanceMAME, they play together nicely.

AdvanceMenu lacks the crazed 3D virtual reality arcade-roaming of other frontends, and because it’s so portable, it doesn’t rely on super-complex window layouts and doohickeys. It’s not plain, though. You can easily set neat browsing options, as seen in the example screenshots page (, or Figure 1-9).

The AdvanceMenu page, showing frontend layouts

Figure 1-9. The AdvanceMenu page, showing frontend layouts

Here’s how to use the program with the normal, vanilla version of MAME:

  1. Download the latest version. I use the Windows version from AdvanceMenu automatically detects many emulators, so make sure you have the latest version of MAME. Unzip AdvanceMenu into the same directory as MAME.

  2. Load the advanced video driver, if necessary. You will find it useful to fire up a command prompt and run the svgalist /l command. This loads the svgawin.sys driver in Windows NT, 2000, and XP. The AdvanceMAME web site has a page explaining this utility. Basically, it’s an advanced video driver that’s useful for running AdvanceMenu.

  3. Choose your options. Click on advancecfg.exe, and you’ll see several text menus with options to navigate through. The details here are impressive; they allow you to send your output to a PC monitor, an arcade machine, a TV, or other custom display devices. For this example, choose PC Monitor. You will see even more complex clock range-related values. I use Generic PC VGA, although I suspect you should look up things in your monitor manual if you can find it. Finally, center your screen appropriately, and save your settings.

  4. Create the mame.ini file. Make sure there’s a mame.ini file in your MAME directory, so run mame -createconfig from the command line. Let’s start simple: have AdvanceMenu find the ROMs directory and load a basic menu that lists each ROM you have in your directory. Edit advmenu.rc to add this line:

    emulator "mame" mame "mame.exe" ""
  5. Keep a close eye on advmenu.rc, because you’ll need to edit it later to customize things further.

In this case, AdvanceMenu figures out the ROM path from the rompath value in mame.ini. If you have screenshots or snapshots for games installed on your version of MAME, it’ll look at snap_directory from the same file to find those. In other words, AdvanceMenu extracts values automatically from MAME’s initialization files so that you don’t have to. That’s the simple approach. Here are a few more advanced options to spiff up your AdvanceMenu fun.


To allow alternate paraphernalia, such as flyers (scans of the original game’s promotional sheets), add the following line to advmenu.rc:

emulator_flyers EMUNAME 

This line sets the LIST directory as the location of the flyers for the games used by the EMUNAME emulator. Find these flyers at the ArcadeFlyers site (

Video previews

A particularly neat feature is the ability to output MNG (animated PNG image) files from AdvanceMAME, compress them with the AdvanceMNG command-line compressor (, and then use the animations in the game selection screen. Other frontends provide video ability, of course, but this one makes it easy to record your favorite boss-beating move in the actual game and make it the default video when you load the emulation in the future. This is eye candy and personal bragging rights bundled together!

However, AdvanceMAME supports only MNG, so there may be incompatibilities with other minivideos from other frontends.

To use, place the video in the normal image preview directory. To choose how the video loops, set the ui_clip option in advmenu.rc.

Flyers as screensavers

AdvanceMenu can segue into a screensaver mode, should you wish it to, displaying the game flyers you’ve installed. Enable this by adding the following to your advmenu.rc file:

idle_screensaver 60 30
idle_screensaver_preview flyers

This starts a screensaver after 60 seconds of idleness, the first time the screensaver runs, and after 30 seconds of idleness on subsequent occasions. The screensaver cycles through the flyers you have stored, since you’ve obviously already added them.

Add a completely different emulator altogether

The documentation ( points out that you can attach any emulator you like to AdvanceMenu, as long as you do it correctly. You’ll need to specify the emulator name, call it a generic type, and then point to the ROMs, also filtering them by filename if you wish. For example, to run the SNES emulator Snes9X, add something like this to your advmenu.rc file:

emulator "snes9x" generic "c:\game\snes9x\snes9x.exe" "%f"
emulator_roms "snes9x" "c:\game\snes9x\roms"
emulator_roms_filter "snes9x" "*.smc;*.sfc;*.fig;*.1"

Alternatives to AdvanceMenu

If AdvanceMenu doesn’t quite fit the bill for you, there are many alternatives and many sites that give advice. The ever-reliable has a very thorough page ( that includes brief and very helpful descriptions of your options, along with version numbers and updates. You can also try the massive MAMEWorld site (, which has one of the best lists of frontends, appearing at the bottom left of the title page. Unfortunately, the latter is completely unannotated, so you’ll have to guess which linked frontends are the best, or just keep reading. Here are some of the best alternatives.

MAME32, a Windows-based all-in-one solution

Although the MAME developers (MAMEDev) sanction their work, the splinter group who produce MAME32 ( aren’t part of the core MAME group. Nonetheless, they do an amazing job of providing an all-in-one MAME solution for Windows users. The overview explains that MAME32 “has an attractive, elegant, graphical interface which allows the user to forego having to type command line parameters.”

After you download MAME32 (, download the supplemental art packages from the same page. It’s quite convenient to have the sometimes difficult-to-find paraphernalia linked from the same site as the binaries. There’s also a very helpful page for installing the artwork packages (; it explains how to plug these add-ons into the program itself. For example, for the prodigiously large amount of screenshots, just copy them into the mame32/snaps folder of your installation. Similarly, for photos of the arcade cabinets themselves, dump them into mame32/cabinets or into one big file that the program can consult when loading.

The MAME32 customization options aren’t complex, but as the MAME32 gallery shows (, you can:

  • Switch fonts by picking Options/Game List Font from the menu

  • Change the game listings to show icons, details, and other information by clicking the icons mounted just below the options menus, or picking the View menu

  • Change which GUI items appear when you start up by checking or unchecking any default options from the View menu

The official MAME32 support page ( isn’t quite comprehensive, but it does have a few good tips, especially regarding keyboard shortcuts. For example, if you’re in the mood for a little Russian Roulette as your arcade game of choice, choose a random ROM by pressing Ctrl-R in the menu. Just don’t blame me if the computer chooses Spy Hunter II, and you end up crying into your expensive arcade joystick. Alternately, if you’d like to skip swiftly to a particular game, use the keyboard to type in its name (or even the first couple of letters). MAME32 selects it automagically, saving you the pain of scrolling up and down maniacally.

3DArcade, the high-end virtual reality approach

3DArcade ( shows the insane lengths people will go to in order to select their MAME games: it’s home to 3D models of arcade machines. This works best when combined with the sophisticated, Windows-only FEArcade frontend ( and allows anyone to set up his own virtual arcade. Stroll up to a machine and press a button to start playing.

Is this 3D GUI over-the-top overkill? Possibly. It’s also rather marvellous, not least of which because it’s fun to imagine what a collection of classic 1982 arcade machines all looked like together in one place. Anyone can make and export cabinets in the fairly standard .W3D format. The 3DArcade models page ( also includes .MAX files for many of the cabinets, if you want to open and adapt them directly in 3D Studio Max.

There are many pictures of the frontend in action (, and you can see some of the really insane arcades created on a special site page ( It’s particularly worth checking out the Deniros-Domus Arcade, described, trippily enough, as “a futuristic take on Frank Lloyd Wright’s Guggenheim Museum set in space.” Of course, trying to climb up a crazed 3D world-based spiral staircase into space just to play your favorite arcade game may not be your idea of fun, but it does have style.


MacMAME is a good all-in-one MAME and frontend solution for Mac users, whether they use OS 9 or OS X. It’s well worth checking out; for a long time, it was the only real option for Mac users who wanted decent menus with their MAME install. See


This Windows-specific frontend is in early development. It’s skinnable and has a neat graphical menu, though it somewhat resembles the Ultracade frontend used for official MAME-style arcade machines running emulated Capcom games. Download it from


ArcadeOS is a DOS-based frontend—particularly useful if you run a PC using MAME exclusively through an arcade stick. Whether you’re using TV-out on your television and aren’t close to your keyboard or you’re using a PC inside an arcade cabinet with a MAME to JAMMA converter, this is the software to beat. You can set your PC to autoboot into this menu without needing a mouse to load a frontend through Windows. Learn more at


This is a Linux/Unix frontend based on Trolltech’s QT library. It’s a comprehensive, good-looking Linux solution. Although at press time it had not seen an update in a while, it’s pretty usable as is. Be sure to install XMame ( before installing QMame (

Get Gaming Hacks now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.