1. Download the latest release from the releases page:

• Latest ASP release: https://github.com/acmeplus/RetroArch-ASP/releases/tag/v1.9.0-asp-beta2
• Latest NGM release: https://github.com/acmeplus/RetroArch-ASP/releases/tag/v1.9.0-ngm-beta1
• Latest MVSX release: https://github.com/acmeplus/RetroArch-ASP/releases/tag/v1.9.0-mvsx-beta2

2. Extract the binary release zip file (e.g. retroarch_asp_beta_20210217.zip) using your favorite unzip tool
3. Put the contents of the extracted folder (retroarch_asp_beta_20210217) into the root folder of your usb key (your usb key should have the retroarch and roms folders)
4. Add your roms to the roms directory
5. Enjoy

After the installation is done retroarch binary will be located at [USB-DRIVE]/retroarch/bin/retroarch. However, in order to run it properly on the ASP you need to call the configuration, the retroarch Libretro core, and the actual rom you need.

There are wrapper scripts for the most common cores in the same binary folder. So if your USB system is using emuinfo.txt to launch emulators, you just need to add an entry to those scripts in the following form:

ngp
/mnt/hdisk/retroarch/bin/ngp
pcfx
/mnt/hdisk/retroarch/bin/pcfx
segacd
/mnt/hdisk/retroarch/bin/segacd
pcsx
/mnt/hdisk/retroarch/bin/pcsx
fbneo
/mnt/hdisk/retroarch/bin/fbneo
neocd
/mnt/hdisk/retroarch/bin/neocd

And to call a particular core and rom, you need to add a dedicated entry in rominfo.txt like:

ID=mygame
EMU=neocd
PATH=/mnt/hdisk/roms/neocd/myromfile

Finally, you have to make sure your game is listed in the dedicated local/English/games.ini like:

[GAME]
[ID]=<42>
[TIME]=< >
[TYPE]=< >
[NAME]=<  >
[DIR]=<mygame>
[GAME\]

Notes:

• ASP Additional cores: There are some libretro cores included in this package, but if you want to test other systems you can download them from libretro nightly build (armv7-neon-hf): libretro nightly

After the installation is done retroarch binary will be located at [USB-DRIVE]/retroarch/bin/retroarch. However, in order to run it properly on the NGM you need to call the configuration, the retroarch Libretro core, and the actual rom you need. There are wrapper scripts for the most common cores in the same binary folder ([USB-DRIVE]/retroarch/bin), as well a generic retroarch_standalone.sh script that launches the retroarch frontend. From there, you can load any of the cores and load a rom, create playlists, etc. Read the RetroArch RGUI Documentation for more details.

To get RetroArch to launch, you need to have a rooted system with a dedicated USB installation. In your NGM USB system, locate the emuinfo.txt file and add an entry to launch retroarch:

retroarch
/vendor2/retroarch/bin/retroarch_standalone.sh
ngp
/vendor2/retroarch/bin/ngp

Locate your rominfo.txt file, and add an entry for retroarch:

ID=retroarch
EMU=retroarch
PATH= --RETROARCH--

Locate your local/English/games.ini file and add an entry at the end:

[GAME]
[ID]=40
[TYPE]=5
[NAME]=RETROARCH
[DIR]=retroarch

Notes:

• The [ID]=40 is an example, you have to increase the number from the last entry you have on your games.ini
• You also need to add an image for both the LCD (png format, 94x78) and TV (png format, 282x242) previews under the images folder. Otherwise the system may not start after you make those changes to the games.ini file.

The MVSX version of RetroArch is almost identical to the ASP version. However, there are two differences:

• Audio is not routed via HDMI but via the internal speakers (HDMI_I2S_2)
• The controls are different, so those need to be mapped from the retroarch menu

To get RetroArch to launch on the MVSX, you need to have a rooted system with a dedicated USB installation.

• I don't have a MVSX, so the initial input mapping has not been tested, however you should be able to remap the controls from the retroarch menu
• The RetroArch version for MVSX does not work via the internal menu. The current mechanism launches RetroArch before your selected menu. If you want to use your preferred menu, you should either use another USB key without retroarch, or quit retroarch from its menu, so the system will resume its normal boot sequence.

• BIOS files: Some systems require dedicated bios files. Please read the libretro documentation for each core to determine which bios files you may need (see here). BIOS should be added to the [USB-DRIVE]/retroarch/bios folder.