Note - This repository is a fork from zerojay's repository which was unmaintained. A lot of stuff is old and might not be working as intended with recent RetroPie.

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 (yet?) for one reason or another. These scripts can be considered experimental at best. Some of these scripts might overwrite their RetroPie's scripts counterparts.

This repository contains scripts that are being worked on and scripts that might not work out-of-the-box or not at all. Use at your own risk, I am not liable for any damage caused by any of these scripts or their affiliated software.

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

The following commands clone the repo to your Raspberry Pi and then run install-scripts.sh to install the scripts in the master branch directly to the proper directories in the RetroPie-Setup/ folder.

cd ~
git clone https://github.com/PabOu-be/RetroPie-Extra.git
cd RetroPie-Extra/
./install-extras.sh

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

Usage

After installing RetroPie-Extra, the extra scripts will be installed directly in the RetroPie Setup script (generally in the experimental section), which you can run from either the command line or from the menu within Emulation Station.

cd ~
cd RetroPie-Setup/
sudo ./retropie_setup.sh

Updating

The following commands update your Raspberry Pi to the latest repo and then run install-scripts.sh to install the scripts in the master branch directly to the proper directories in the RetroPie-Setup/ folder.

cd ~
cd RetroPie-Extra/
git pull origin
./install-extras.sh

Updating from zerojay's repository

The following commands will remove old files from the zerojay's repository which might conflict with this one.

cd ~
rm -rf RetroPie-Extra

You may now proceed with the installation of this repository (see the corresponding instructions above).

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.

Included Software

Master Branch

Emulators

- atari800.sh - Atari 800/5200 emulator with additional joystick support - 5200 is tested, 800 is not.
- gearboy.sh - Gameboy emulator - Tested and works well.
- kat5200.sh - Atari 8-bit/5200 emulator - Only set up for 5200 at the moment.
- pokemini.sh - Pokemon Mini emulator - Tested and works well.

Libretrocores

- lr-mame2003_midway.sh - MAME 0.78 core with Midway games optimizations.

Ports

Supplementary

- fun-facts-splashscreens.sh - Set up some loading splashscreens with fun facts.
- joystick-selection.sh - Set controllers for RetroArch players 1-4.
- screenshot.sh - Take screenshots remotely through SSH - Tested and works well.

Future To-Do List

Have a look at the TODO.md file.

Hall of Fame - Scripts accepted into RetroPie-Setup

nothing yet.

Contact Info / Additional Information

Email: pabou@pabou.com

mrgeyer/RetroPie-Extra