EmulationStation/SYSTEMS.md

Systems

This outlines how to add support for many different systems into EmulationStation through configuration of es_systems.cfg.

Nintendo Wii

Dolphin

In Options → Configure → Interface, disable Confirm to Stop.

<system>
  <name>wii</name>
  <fullname>Nintendo Wii</fullname>
  <path>/rom/path/here</path>
  <extension>.elf .dol .gcm .iso .wbfs .ciso .gcz .wad</extension>
  <command>dolphin-emu -b -e %ROM%</command>
  <platform>wii</platform>
  <theme>wii</theme>
</system>

Nintendo GameCube

Dolphin

In Options → Configure → Interface, disable Confirm to Stop.

<system>
  <name>gc</name>
  <fullname>Nintendo GameCube</fullname>
  <path>/rom/path/here</path>
  <extension>.elf .dol .gcm .iso .wbfs .ciso .gcz .wad</extension>
  <command>dolphin-emu -b -e %ROM%</command>
  <platform>gc</platform>
  <theme>gc</theme>
</system>

Nintendo 64

RetroArch

Requires a Nintendo N64 Core, like libretro-mupen64plus.

<system>
  <name>n64</name>
  <fullname>Nintendo 64</fullname>
  <path>/path/to/roms</path>
  <extension>.z64 .zip .n64</extension>
  <command>retroarch --fullscreen -L /usr/lib/libretro/mupen64plus_libretro.so %ROM%</command>
  <platform>n64</platform>
  <theme>n64</theme>
</system>

Mupen64Plus

<system>
  <name>n64</name>
  <fullname>Nintendo 64</fullname>
  <path>/path/to/roms</path>
  <extension>.z64 .zip .n64</extension>
  <command>mupen64plus --nogui --noask --noosd --fullscreen %ROM%</command>
  <platform>n64</platform>
  <theme>n64</theme>
</system>

Nintendo Entertainment System

RetroArch

Requires a Nintendo NES Core, like libretro-fceumm.

<system>
  <name>nes</name>
  <fullname>Nintendo Entertainment System</fullname>
  <path>/path/to/roms</path>
  <extension>.nes .NES .zip</extension>
  <command>retroarch --fullscreen -L /usr/lib/libretro/fceumm_libretro.so %ROM%</command>
  <platform>nes</platform>
  <theme>nes</theme>
</system>

Mednafen

<system>
  <name>nes</name>
  <fullname>Nintendo Entertainment System</fullname>
  <path>/path/to/roms</path>
  <extension>.nes .NES .zip</extension>
  <command>mednafen -video.fs 1 %ROM%</command>
  <platform>nes</platform>
  <theme>nes</theme>
</system>

Super Nintendo Entertainment System

ZSNES

<system>
  <name>snes</name>
  <fullname>Super Nintendo Entertainment System</fullname>
  <path>/path/to/roms</path>
  <extension>.smc .sfc .swc .fig .mgd .mgh .ufo .bin .gd3 .gd7 .usa .eur .jap .aus .st .bs .dx2 .048 .058 .078 .1 .a .gz .zip .jma</extension>
  <command>zsnes -m %ROM%</command>
  <platform>snes</platform>
  <theme>snes</theme>
</system>

RetroArch

Requires a Nintendo SNES Core, like libretro-snes9x-next.

<system>
  <name>snes</name>
  <fullname>Super Nintendo Entertainment System</fullname>
  <path>/path/to/roms</path>
  <extension>.smc .sfc .fig .bin .zip</extension>
  <command>retroarch --fullscreen -L /usr/lib/libretro/snes9x_next_libretro.so %ROM%</command>
  <platform>snes</platform>
  <theme>snes</theme>
</system>

Atari 2600

Stella

<system>
  <name>atari2600</name>
  <fullname>Atari 2600</fullname>
  <path>/path/to/roms</path>
  <extension>.bin .zip</extension>
  <command>stella %ROM%</command>
  <platform>atari2600</platform>
  <theme>atari2600</theme>
</system>

Nintendo GameBoy Advance

Mednafen

<system>
  <name>gba</name>
  <fullname>Nintendo GameBoy Advance</fullname>
  <path>/path/to/roms</path>
  <extension>.gba .zip</extension>
  <command>mednafen -video.fs 1 %ROM%</command>
  <platform>gba</platform>
  <theme>gba</theme>
</system>

VisualBoyAdvance

<system>
  <name>gba</name>
  <fullname>Nintendo GameBoy Advance</fullname>
  <path>/path/to/roms</path>
  <extension>.gba .zip</extension>
  <command>VisualBoyAdvance -F %ROM%</command>
  <platform>gba</platform>
  <theme>gba</theme>
</system>

RetroArch

Requires a Nintendo GameBoy Advance Core, like libretro-vba-next.

<system>
  <name>gba</name>
  <fullname>Nintendo GameBoy Advance</fullname>
  <path>/path/to/roms</path>
  <extension>.gba .zip</extension>
  <command>retroarch --fullscreen -L /usr/lib/libretro/vba_next_libretro.so %ROM%</command>
  <platform>gba</platform>
  <theme>gba</theme>
</system>

Steam

1. Create a folder at ~/.emulationstation/steam

mkdir -p ~/.emulationstation/steam

2. Add text files for each Steam game you would like to have available through EmulationStation where:

• The file name represents the game's name
• The contents of the file represents the Steam application ID (found from the game's Steam store page)

cd ~/.emulationstation/steam
echo "250900" >> "The Binding of Isaac: Rebirth.txt"

<system>
  <name>steam</name>
  <fullname>Steam</fullname>
  <path>~/.emulationstation/steam</path>
  <extension>.txt</extension>
  <command>steam steam://rungameid/$(tail %ROM%)</command>
  <platform>pc</platform>
  <theme>steam</theme>
</system>

PlayStation Portable

PPSSPP

<system>
  <name>psp</name>
  <fullname>PlayStation Portable</fullname>
  <path>/path/to/roms</path>
  <extension>.iso</extension>
  <command>ppsspp --fullscreen --escape-exit "%ROM_RAW%"</command>
  <platform>psp</platform>
  <theme>psp</theme>
</system>