diff --git a/README.md b/README.md index 5c187a445..829df1c83 100644 --- a/README.md +++ b/README.md @@ -148,7 +148,7 @@ All systems must be contained within the tag.--> Super Nintendo Entertainment System - ~/roms/snes @@ -180,6 +180,7 @@ The following "tags" are replaced by ES in launch commands: `%ROM_RAW%` - Replaced with the unescaped, absolute path to the selected ROM. If your emulator is picky about paths, you might want to use this instead of %ROM%, but enclosed in quotes. +See [SYSTEMS.md](SYSTEMS.md) for some live examples in EmulationStation. gamelist.xml ============ diff --git a/SYSTEMS.md b/SYSTEMS.md new file mode 100644 index 000000000..aedc1e34a --- /dev/null +++ b/SYSTEMS.md @@ -0,0 +1,183 @@ +# Systems + +This outlines how to add support for many different systems into EmulationStation through configuration of `es_systems.cfg`. + +## Nintendo Wii + +### [Dolphin](http://dolphin-emu.org/) +In Options → Configure → Interface, disable *Confirm to Stop*. +``` xml + + wii + Nintendo Wii + /rom/path/here + .elf .dol .gcm .iso .wbfs .ciso .gcz .wad + dolphin-emu -b -e %ROM% + wii + wii + +``` + + +## [Nintendo GameCube](https://en.wikipedia.org/wiki/GameCube) + +### [Dolphin](http://dolphin-emu.org/) +In Options → Configure → Interface, disable *Confirm to Stop*. +``` xml + + gc + Nintendo GameCube + /rom/path/here + .elf .dol .gcm .iso .wbfs .ciso .gcz .wad + dolphin-emu -b -e %ROM% + gc + gc + +``` + + +## Nintendo 64 + +### [RetroArch](http://libretro.com) +Requires a [Nintendo N64 Core](http://wiki.libretro.com/index.php?title=Nintendo_N64_Core_Compatibility), like [`libretro-mupen64plus`](http://wiki.libretro.com/index.php?title=Mupen64Plus). +``` xml + + n64 + Nintendo 64 + /path/to/roms + .z64 .zip .n64 + retroarch --fullscreen -L /usr/lib/libretro/mupen64plus_libretro.so %ROM% + n64 + n64 + +``` + +### [Mupen64Plus](https://code.google.com/p/mupen64plus/) +``` xml + + n64 + Nintendo 64 + /path/to/roms + .z64 .zip .n64 + mupen64plus --nogui --noask --noosd --fullscreen %ROM% + n64 + n64 + +``` + + +## Nintendo Entertainment System + +### [RetroArch](http://libretro.com) +Requires a [Nintendo NES Core](http://wiki.libretro.com/index.php?title=Nintendo_NES_Core_Compatibility), like [`libretro-fceumm`](http://wiki.libretro.com/index.php?title=FCEUmm). +``` xml + + nes + Nintendo Entertainment System + /path/to/roms + .nes .NES .zip + retroarch --fullscreen -L /usr/lib/libretro/fceumm_libretro.so %ROM% + nes + nes + +``` + +### [Mednafen](http://mednafen.sourceforge.net/) +``` xml + + nes + Nintendo Entertainment System + /path/to/roms + .nes .NES .zip + mednafen -video.fs 1 %ROM% + nes + nes + +``` + + +## Super Nintendo Entertainment System + +### [ZSNES](http://zsnes.com/) +``` xml + + snes + Super Nintendo Entertainment System + /path/to/roms + .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 + zsnes -m %ROM% + snes + snes + +``` + +### [RetroArch](http://libretro.com) +Requires a [Nintendo SNES Core](http://wiki.libretro.com/index.php?title=Nintendo_SNES_Core_Compatibility), like [`libretro-snes9x-next`](http://wiki.libretro.com/index.php?title=SNES9x_Next). +``` xml + + snes + Super Nintendo Entertainment System + /path/to/roms + .smc .sfc .fig .bin .zip + retroarch --fullscreen -L /usr/lib/libretro/snes9x_next_libretro.so %ROM% + snes + snes + +``` + +## Atari 2600 + +### [Stella](http://stella.sourceforge.net/) +``` xml + + atari2600 + Atari 2600 + /path/to/roms + .bin .zip + stella %ROM% + atari2600 + atari2600 + +``` + +## Nintendo GameBoy Advance + +### [Mednafen](http://mednafen.sourceforge.net/) +``` xml + + gba + Nintendo GameBoy Advance + /path/to/roms + .gba .zip + mednafen -video.fs 1 %ROM% + gba + gba + +``` + +### [VisualBoyAdvance](http://sourceforge.net/projects/vba/) +``` xml + + gba + Nintendo GameBoy Advance + /path/to/roms + .gba .zip + VisualBoyAdvance -F %ROM% + gba + gba + +``` + +### [RetroArch](http://libretro.com) +Requires a [Nintendo GameBoy Advance Core](http://wiki.libretro.com/index.php?title=Nintendo_Game_Boy_Advance_Core_Compatibility), like [`libretro-vba-next`](http://wiki.libretro.com/index.php?title=VBA_Next). +``` xml + + gba + Nintendo GameBoy Advance + /path/to/roms + .gba .zip + retroarch --fullscreen -L /usr/lib/libretro/vba_next_libretro.so %ROM% + gba + gba + +```