A quick guide on getting Wah!Cade up and running with the xMame emulator.
Assumptions
- Wah!Cade is installed.
-
Mame files (i.e. roms, artwork, etc.) are installed in
~/emulators/mame. For the layouts to work correctly, you'll probably need to download a set of screenshots, marquees, control panel images, etc. See here for more details. All artwork files must be unzipped into the relevant directories. As a guide, the standard is usually:- roms:
~/emulators/mame/roms - screenshots:
~/emulators/mame/snap - marquees:
~/emulators/mame/marquees - control panels:
~/emulators/mame/cpanel - flyers:
~/emulators/mame/flyers - etc, etc...
- roms:
Step 1: Configure Mame
-
First thing is to make sure you can run xmame on it's own without a frontend. Try:
xmame pacman
(obviously change "pacman" for a rom you know you have). If you get errors then you probably need to edit your ~/.xmame/xmamerc or ~/.xmame/xmame-x11rc files. -
For filters to work properly, download the latest
catver.ini category
version information file (mirrored here),
and save it to:
~/emulators/mame/catver.ini -
In order for the History Viewer to work properly, download the latest
history.dat game
history information file, and save it to:
~/emulators/mame/history.dat -
To get the Control Panel Viewer to work, download the latest
controls.ini
file (don't get the .xml version), and save it to:
~/emulators/mame/controls.ini
Step 2: Configure Wah!Cade
-
Run the Wah!Cade Setup Editor:
wahcade-setup
On the Emulators tab, make sure that List Generation: Rom Directory points to your mame roms (e.g.~/emulators/mame/roms)
Step 3: Configure extra Mame settings
-
On the Mame Only tab, either create the mameinfo.xml file by clicking the Generate File button,
or make sure that the XML / Data File points to your mameinfo.xml file,
then ensure that:
- Category / Version File points to your catver.ini file
- History Viewer: Data File points to your history.dat file
- Control Paner Viewer: Controls File points to your controls.ini file
Step 4: Setup Filters
- On the Mame Only tab, click the Setup Filters... button.
-
A creating initial filter screen should first be displayed.

-
After a (hopefully not too long) pause, the full list of matched games should be displayed:

Step 5: Play
-
Run Wah!Cade in a window:
wahcade -w -
Or full-screen:
wahcade -f -
Then (hopefully), you should see something similar to:
