RetroPie-Extra

This is a collection of unofficial installation scripts for RetroPie allowing you to quickly and easily install emulators, ports and libretrocores that haven't been included in RetroPie for one reason or another. These scripts can be considered experimental at best.

Those in the master branch have been tested reasonably and should work well but may have some flaws as they haven't gone through the RetroPie's watchful eyes yet. Scripts that are unfinished, untested, unpolished will not be located in this repository and instead have been moved to https://github.com/zerojay/RetroPie-Extra-unstable.

Pull requests and issue reports are accepted and encouraged as well as requests. Feel free to use the issue tracker to send me any personal requests for new scripts that you may have.

Installation

Install the extra scripts

The following clones the repo to your Pi and then the install-scripts.sh installs the scripts in the master branch directly to the proper directories in RetroPie-Setup.

git clone https://github.com/zerojay/RetroPie-Extra.git
cd RetroPie-Extra/
./install-extras.sh

Run the RetroPie Setup Script (the extra scripts will be in the experimental section)

cd
cd RetroPie-Setup
sudo ./retropie_setup.sh

This script assumes that you are running it on a Raspberry Pi with the RetroPie-Setup being stored in /home/pi/RetroPie-Setup. If your setup differs, just copy the scripts directly to the folder they need to be in.

Troubleshooting

Here are some helpful hints for getting around some possible issues that you may encounter.

The port I installed appears to close immediately upon launching.

In most cases, this is likely because the port requires external data files, especially in the case of game engines. In cases where shareware datafiles are available, the port will install them where possible. Otherwise, you will need to provide your own. The warning dialog box at the end of installation should usually tell you what files will be needed and where to place them. If you somehow don't see a dialog box after installation, you can open the script itself and look towards the bottom for the warning.

Another possible case is the port uses the X11 windowing system. In some cases, I've included the X11 window system because of issues such as the game not going fullscreen, or just not functioning at all without it. In these cases, you will need to tell the system that it is okay for users other than root to use X11. You can do this by running the following command:

dpkg-reconfigure x11-common

In the dialog box that comes up, you can select which users are allowed to use the X11 system. I would suggest you allow the pi user or anyone to run X11. This only needs to be done one time to fix the issue for all ports and programs that use the X11 window system. I would even suggest doing it now even if you have no intention yet of installing a port that uses X11 yet so that you do not need to deal with this issue in the future.

Included Software

Master Branch

Emulators

• - gearboy.sh - Gameboy emulator - Tested and works well.
• - oricutron.sh - Oricutron Oric 1/Oric Atmos emulator - Tested and works well.
• - sdltrs.sh - Radio Shack TRS-80 Model I/III/4/4P emulator - Tested and works well.
• - ti99sim.sh - Texas Instruments 99A emulator - Tested and works well.

Ports

• - bermudasyndrome.sh - Bermuda Syndrome engine - Tested, runs, possibly instable.
• - bloboats.sh - Fun physics game - Tested and works well, OpenGL game running through glshim.
• - breaker.sh - Arkanoid clone - Tested and works well.
• - burgerspace.sh - BurgerTime clone - Tested and works well.
• - chocolate-doom.sh - DOOM source port - Tested and works well.
• - chromium.sh - Open Source Web Browser - Tested and works well.
• - corsixth.sh - Theme Hospital engine clone - Tested and works well.
• - crack-attack.sh - Tetris Attack clone - Tested and works well. Minor color issue needs to be fixed with glshim.
• - crispy-doom.sh - DOOM source port - Tested and works well.
• - deadbeef.sh - Music and ripped game music player - Tested and works well.
• - easyrpgplayer.sh - RPG Maker 2000/2003 interpreter - Tested and works well.
• - freeciv.sh - Civilization online clone - Tested and works well, I may soon replace it to compile latest freeciv so that players can play with newer clients.
• - freesynd.sh - Syndicate clone - Tested and has occasional crash issues. Save between levels to avoid losing progress.
• - gamemaker.sh - Install the 3 gamemaker games - Tested and works well.
• - ganbare.sh - Japanese 2D Platformer - Tested and works well, does not require Japanese to play.
• - heboris.sh - Tetris The Grand Master clone - Tested and works well, does not include audio, user needs to provide their own soundpack.
• - iceweasel.sh - Rebranded Firefox Web Browser - Tested and works well.
• - kaiten-patissier-cs.sh - Japanese 2D Platformer - Tested and works well, has English mode.
• - kaiten-patissier-ura.sh - Japanese 2D Platformer - Tested and works well, has English mode.
• - kaiten-patissier.sh - Japanese 2D Platformer - Tested and works well, has English mode.
• - kodi-extra.sh - Kodi Media Player 16 with controller support as a separate system - Tested and works well.
• - kweb.sh - Minimal kiosk web browser - Tested and working well generally. Media may not be working well, I need to understand it better first to say.
• - manaplus.sh - 2D MMORPG client - Tested and works well, requires mouse.
• - maelstrom.sh - Classic Mac Asteroids Remake - Tested and works well, button configuration screen may crash.
• - mayhem.sh - Remake of the Amiga game - Tested and works well.
• - pingus.sh - Lemmings clone - Tested and works well, requires mouse.
• - rawgl.sh - Another World source port - Tested, occasionally crashes when button held when switching scenes?
• - reminiscence.sh - Flashback engine clone - Tested and works well.
• - roadfighter.sh - RoadFighter clone - Tested and works well.
• - rott.sh - Rise of the Triad source port - Tested and works well.
• - sdl-bomber.sh - Simple Bomberman clone - Tested and works well, turn down the volume perhaps.
• - smw-netplay.sh - Super Mario War with netplay - Tested and works well, netplay untested?
• - sorr.sh - Streets of Rage Remake port - Tested and works well. Use fullscreen fast video mode.
• - tinyfugue.sh - MUD client - Tested and works well.
• - ulmos-adventure.sh - Simple Adventure Game - Tested and works well.
• - vorton.sh - Highway Encounter Remake in Spanish - Tested and works well.
• - weechat.sh - Console IRC Client - Tested and works well.
• - wizznic.sh - Puzznic clone - Tested and works well.

Supplementary

• - attract-mode.sh - Emulator Frontend - Tested and works well, not intended to completely replace EmulationStation.
• - screenshot.sh - Take screenshots remotely through SSH - Tested and works well.
• - splashscreen-extra.sh - Install additional user-created splashscreens for RetroPie - Tested and works well.

Future To-Do List (not ordered by priority)

• - glshim
• - SDLash/Xash Half-Life engine through glshim.
• - Beatfever Mania.
• - Stepmania/Frets on Fire through glshim/new OpenGL driver.
• - Mupen64Plus videocore plugin - Awaiting fixed code (gizmo98?)
• - John's Shadow Warrior Port (jswp)

Hall of Fame - Scripts accepted into RetroPie-Setup

• - LXDE - LXDE Desktop
• - SimCoupe - Sam Coupe Emulator

Contact Info/Additional Information

Twitter: @zerojay - often posting new information and additions from the repository to the #retropie hashtag.
IRC: zerojay on irc.freenode.net, #retropie/#retropie-extra.

If you wish to be up-to-date about all the changes happening to the repository as they happen, feel free to join the #retropie-extra channel on Freenode.