Machines ROMs/CHDs and software lists ROMs/CHDs are supported.
ia-rcade please read the legal
Mac OS x Users: Some users reported issues to install Java Superior to 6. If it is you case, read this Stack Overflow thread.
A version of Mame 0.149+ that
suits your operating system. Make sure Mame is correctly installed
and works as expected before trying
ia-rcade. Recommended version
is one that match exactly one of the available romsets at
As of now, available romsets range from 0.149 to 0.197. So
recommended version is 0.197. If your Mame version does not match
exactly a romset version,
ia-rcade searchs for roms in greatest
romsets version less than your Mame version. In this case, some
required files may be missing. Its a hit or miss but works pretty
well if the version delta between Mame and romsets is not too high.
Previous versions of Mame are available
ia-rcade can be considered safe, it is for now a beta software. It
should not affect the roms into your rompath. But if you take care of your
collection, it would be safer to try
ia-rcade with another rompath. See
If you change your version of Mame, i recommend you to use another empty
rompath to prevent a
mixed versions romset. Some roms could have been
changed from a romset version to another so it is safer to download them
Make your rompath writable or add another writable one on the
'rompath' directive of
$ chmod +w /path/to/mame/roms
ia-rcade and make it executable:
$ sudo curl -fsSLo /usr/local/bin/ia-rcade https://github.com/TiBeN/ia-mame/releases/download/1.2/ia-rcade $ sudo chmod +x /usr/local/bin/ia-rcade
ia-rcade where is your Mame executable by making it available
on your \$PATH environment variable — its name must match
mame[.exe] — or by setting on your \~./bashrc, or
\~/.bash_profile or somewhere else, the \$MAME_EXEC environment
$ vim ~/.bashrc export MAME_EXEC=/path/to/mame64
You can alternatively place it somewhere else and use the \$MAME_EXEC env variable:
C:\> SET MAME_EXEC=C:\Users\tiben\mame\mame.exe
The compilation requires
git clone this repository:
$ git clone https://github.com/TiBeN/ia-rcade
Build and package using maven:
$ cd /path/to/ia-rcade $ mvn package
The binary files
ia-rcade (Linux/OS X) and
ia-rcade.exe (Windows) and
the executable jar are available on the
ia-rcade acts like a
command wrapper of the original Mame executable.
Use it exactly like the original Mame command line. When you launch a
game or a system,
ia-rcade looks at your rompath to determine what
ROM/CHD files are missing and fetch them from archive.org into your
rompath. Once the files are downloaded, it returns control to original
Mame executable which launches the game/system.
Galaxian. Simply type what you would have typed with the original
Mame to launch the game:
$ ia-rcade galaxian
Let's try Pacman. Open a console
cmd then type:
C:\> cd \path\to\mame C:\> ia-rcade.exe pacman
Alternatively, the provided executable jar can be used directly:
$ java -jar ia-rcade.jar sf2
If you want to try
ia-rcade using a different rompath than your Mame's
default, you can use the original Mame option
-rompath on the
$ ia-rcade -rompath /tmp sms sonic
It is possible to run
ia-rcade without running Mame afterward using the
-noexecmame option. This can be useful if you only want to download a
rom file without execute the game. If the rom is already available,
ia-rcade simply does nothing.
$ ia-rcade -noexecmame sms sonic
ia-rcade does not work when used with the included Mame GUI. However it
should work with frontends using some tweaks. Reddit user
managed to make
ia-rcade work in his
with the frontend attract-mode.
ia-rcade relies on romsets
archive.org. Not all romsets for all Mame versions are hosted and some
versions miss parts like softwarelist or chd sets.
ia-rcade tries to
find missing roms in previous collections but olders roms may not work
with a more recent version of Mame.
ia-rcade is an independant project and is in any way associated
with the official Mamedev team.
ia-rcade uses archive.org as a service and does not host nor provide
directly any rom file.
Some rom files are the proprietary of copyright holders.
If you want to contribute or simply share your thoughs about
feel free to send your pull requests here at github or join me at
One really simple contribution is keep me informed when new romsets are hosted at archive.org.
Releases announces on reddit triggered some good discussions: