Adding games to RetroX is as easy as putting the games into a folder and make RetroX scan it. Folders with games can be stored in the device’s own storage, cloud services like Dropbox or Google Drive and network area storage devices (NAS). Watch this basic video tutorial or continue reading for detailed info.
Please note that all users start with a trial period. Once the trial period finishes you will be restricted to only 6 games, you need to upgrade your user account with an Activation Code to remove this limitation.
There are three methods to add games to RetroX:
- Single games: Just point RetroX where your game is and it will be added.
- Folder for one system: This method will add a whole folder containing games for a single system (nes, genesis, etc).
- RetroX Collection: This method will add a single folder containing games for multiple systems. This method is more advanced and it is recommended if you want to prepare an USB drive or SD card to just plug and play on your devices.
Any of the three methods are supported when using local storage (internal/USB/SD card) and remote storage like DropBox and Google Drive. Just keep in mind the following:
- The game must be in a supported file format for each emulator (.atr, .z64, .cue, etc). See the list below.
- The game can be compressed as .zip, .rar or .7z, but we don’t recommend it. It will take more time to start a game and it will require more storage to hold the compressed and uncompressed version. Emulators need the game to be uncompressed (except for MAME).
- When using local storage, a single compressed file can hold more than one game.
- When using remote storage, a single compressed file must hold only one game. The game name will be guessed from the compressed file name and it will not be opened until you start the game.
- Some systems are only supported in local storage: ScummVM and MS-DOS games.
- It is well known that when ES Explorer manages your external drive, it can disconnect it from Android and no other app will be able to access it. If your games are not found, make sure that you are not using the drive in ES Explorer.
Zipped or unzipped
MAME is the only emulator that uses compressed files as input, all other emulators require the files to be uncompressed. RetroX will scan and recognize your game files compressed with zip, 7zip and rar, but before starting the game, RetroX must uncompress the game to run the emulator. The uncompression will take some time if the file is too large, and the uncompressed copy will be put in your internal storage.
So your options are:
- zipped: it uses less space in your original storage, but the decompression will require more time to start the game for the first time and the unzipped copy will use your internal storage. Anyway, you can always remove the local copy using the “uninstall” option in Settings -> Device and in the Game Details screen.
- unzipped: it uses more space in your original storage, but the emulator will just use that copy to start the game, no additional space needed. Because the game doesn’t need to be uncompressed, it will start immediately.
Supported file formats
The following is the list of supported file formats for each system. Your file can be stored inside a compressed file (.zip, .rar, .7z) according to the restrictions stated above.
Atari 2600 bin a26 Atari 5200 a52 Atari 7800 bin a78 Atari Jaguar j64 jag Atari Lynx lnx Atari XL/XE atr xex exe car Final Burn Alpha zip 7z Commodore Amiga adf hdf Game Boy gb Game Boy Advance gba Game Boy Color gbc gb MAME zip 7z MSX cas dsk mx1 mx2 col rom Nintendo 64 n64 v64 z64 Nintendo Entertainment System nes Panasonic 3DO iso bin img PC MS-DOS one folder PC Engine / TurboGrafx pce cue Playstation iso cue bin img mdf pbp toc cbn m3u PSP iso elf cso prx pbp ScummVM one folder Sega 32X 32x Sega CD iso cue bin Sega Dreamcast gdi cdi chd(v4) Sega Game Gear gg Sega Genesis/MegaDrive mdx md smd gen iso cue bin sms gg sg Sega Master System sms Super Nintendo smc sfc
Scanning and re-scanning
When you add a single game RetroX will scan the file and add it to the list. Once in the list it will stay permanent unless you remove it in the Game Details screen (the one that has the Play button). Note that you can always remove the file from the list, but RetroX will not remove the file from your storage.
When you add s single folder RetroX will scan it looking for games for the system that you selected. It will not scan the folder again unless you request it to. So if you add or remove games to that folder, you must request a rescan in Manage Games -> Manage Folders, then select the folder and use the option to rescan.
If you are using a RetroX Collection you need to request a rescan the first time and every time you add or remove games on it. Use the option Manage Games -> Rescan.
A RetroX Collection is a unified folder structure to organize your collection under an unique retrox folder at the root of any of your Android drives. This folder structure can be created through RetroX itself, just go to Manage Games -> Manage folders, select the drive and the app will offer you to create or update your folder structure. In cases where Android forbids the app to write in your device, you can use a computer or an Android file manager to create the folders yourself.
In the example below taken from a Samsung device, you can see that RetroX will look into the folders /sdcard/retrox and /storage/extSdCard/retrox :
The official names for the current supported platforms are (case sensitive):
retrox/3do Panasonic 3DO retrox/atari Atari XL/XE/5200 retrox/atari2600 Atari 2600 (VCS) retrox/atari7800 Atari 7800 retrox/amiga Commodore Amiga (Read additional details below) retrox/dc Sega Dreamcast retrox/dos MS-DOS (Read additional details below) retrox/fba Final Burn Alpha retrox/gamegear Sega Game Gear retrox/gb GameBoy retrox/gba GameBoy Advance retrox/gbc GameBoy Color retrox/genesis Sega Genesis retrox/jaguar Atari Jaguar retrox/lynx Atari Lynx retrox/mame MAME (Read additional details below) retrox/msx MSX (Read additional details below) retrox/n64 Nintendo 64 retrox/nes Nintendo Entertainment System retrox/pcengine PC Engine retrox/psp PlayStation Portable retrox/psx PlayStation retrox/scummvm ScummVM (Read additional details below) retrox/sega32x Sega 32X retrox/segacd Sega CD retrox/snes Super Nintendo retrox/sms Sega Master System
As an example, this is a valid folder structure for 6 Sega Genesis games. Two of them are uncompressed and three of them are compressed into one zip called moregames.zip
retrox/genesis/mygame.smd retrox/genesis/othergame.smd retrox/genesis/moregames.zip:bestgame.smd retrox/genesis/moregames.zip:amazinggame.smd retrox/genesis/moregames.zip:goodgame.smd
RetroX will try to auto detect your games. If your game is detected, RetroX will display the cover and screenshots of that game, it will also download any specific configuration that could be required to run that game. That configuration can be a special keyboard mapping, CPU emulation type, among others.
At first, RetroX will try to detect your game using its name. The name will be converted to a standard code and that will be used to search into its games database. These are examples of that conversion:
Mega Turrican.smd -> megaturrican Pole Position.atr -> poleposition
If the game is not detected by this automatic code, RetroX will read the contents of the file to look for a specific id to search into the games database. Your game may be not recognized today, but the code is being improved as we advance the development and add more games to the database
Commodore Amiga has games that require more than one disk, that means that you will have more than one file for each game.
These are specific instructions for Commodore Amiga Multi Disk Support.
For multi disk Amiga games, the game code is taken from the directory containing the game. For example this will be recognized as fireandice
An MS-DOS game is a collection of files inside a directory. This directory and it files can be compressed or uncompressed, but we strongly recommend to use uncompressed files to avoid having RetroX to uncompress and use more time and space when you start the game.
Don’t worry if you don’t understand how to make them run, MS-DOS games does require some experience with the original MS-DOS system.
This is an example of a simple MS-DOS game ready for RetroX
retrox/dos/mygame/game.dat retrox/dos/mygame/game.exe retrox/dos/mygame/read.me retrox/dos/mygame/dosbox.conf
The first three files are from the original game. The dosbox.conf file must be created by you and it will contain the instructions required to run the game. This is a standard dosbox.conf file, but you don’t need to create the entire file. RetroX will merge a default dosxbox.conf with the one inside “mygame”. You only need to put the specific config for your game.
This is the simplest dosbox.conf that you may need (game.exe comes from this example)
[autoexec] mount c . c: game.exe exit
Of course you can add additional config lines for memory settings or cpu speed. Refer to the original DosBox documentation. This is an example of a extended dosbox.conf file
[cpu] cycles=22000 [dos] xms=false ems=false umb=false [autoexec] mount c . c: game.exe exit
The game code is taken from the directory containing the game. For example this will be recognized as coolspot
MAME games depends directly on the version of the MAME emulator. To make things easy, RetroX use four folders to look for games.
retrox/mame/2001 MAME 0.37b retrox/mame/2003 MAME 0.78 retrox/mame/2010 MAME 0.139 retrox/mame/2014 MAME 0.159
Just put the .zip or .7z files on those folders. DON’T UNCOMPRESS THEM!
This is an example
retrox/mame/2001/1942.zip retrox/mame/2001/commando.zip retrox/mame/2001/dkong.zip retrox/mame/2003/area88.zip retrox/mame/2003/flipshot.zip retrox/mame/2014/matmania.7z
Adding MAME games is not as simple as adding a console game, please continue reading this specific MAME doc to know more about it.
Final Burn Alpha
Just put the individual .zip or .7z files your fba folder. DON’T UNCOMPRESS THEM!
MSX has games that require more than one disk, that means that you will have more than one file for each game.
These are specific instructions for MSX Multi Disk Support.
For multi disk games, the game code is taken from the directory containing the game. For example this will be recognized as golvellius2
Each ScummVM game is a collection of files inside a directory, they were originally MS-DOS games (or Amiga).
The name of the directory has to be the code that ScummVM define for each game.
This is an example for the game Day of the Tentacle, with ScummVM code “tentacle”
If you want to add your own artwork, you will need three files named like:
* cover.jpg This is the game cover * shot.0.png This is the first screenshot * shot.1.png This is the second screenshot * shot.2.png This is the third screenshot
Usually, the first screenshot is the game title, and its hidden because the game cover already has something like that, so you can take it as optional.
The exact name will depend on how the game file is being stored. If the game uses a folder to contain many files like MS DOS, Amiga or ScummVM, you only need to add these files to the folder.
This is an example of an Amiga game inside its own folder
retrox/amiga/Turrican II/turrican2.disk1.adf retrox/amiga/Turrican II/turrican2.disk2.adf retrox/amiga/Turrican II/cover.jpg retrox/amiga/Turrican II/shot.0.png retrox/amiga/Turrican II/shot.1.png retrox/amiga/Turrican II/shot.2.png
If the game is not in a folder, you must add the game file name before the artwork name. This in example for this case:
retrox/atari/dimosquest.atr retrox/atari/dimosquest.cover.jpg retrox/atari/dimosquest.shot.0.png retrox/atari/dimosquest.shot.1.png retrox/atari/dimosquest.shot.2.png