marc-etienne / retropie-setup

Shell script to setup Raspberry Pi (TM) with RetroArch emulator and various cores

RetroPie-Setup

General Usage

Shell script to setup Raspberry Pi (TM) with several emulators, various cores, and EmulationStation as graphical front end.

This script is tested with the Raspbian distribution, but users have reported that it also works with RaspBMC. Before using the script, please make sure that you have run the raspi-config script to extend your root file system and that your memory split is set to 192 or 128. You can run the script with

sudo raspi-config

To run the RetroPie Setup Script make sure that your APT repositories are up-to-date and that Git and the dialog package are installed:

sudo apt-get update
sudo apt-get upgrade -y
sudo apt-get install -y git dialog

Then you can download the latest RetroPie setup script with

cd
git clone --depth=0 git://github.com/petrockblog/RetroPie-Setup.git

The script is executed with

cd RetroPie-Setup
chmod +x retropie_setup.sh
sudo ./retropie_setup.sh

Optional arguments can be passed to the script. If called with

sudo ./retropie_setup.sh

the installation directory is /home/CURRENTUSER/RetroPie for the current user, where CURRENTUSER is the home directory of the current user. If called with

sudo ./retropie_setup.sh USERNAME

the installation directory is /home/USERNAME/RetroPie for user USERNAME. If called with

sudo ./retropie_setup.sh USERNAME ABSPATH

the installation directory is ABSPATH for user USERNAME.

Note that you might need to reboot your Raspberry, if your firmware was updated during the installation process.

Binaries and Sources

RetroPie Setup offered the possibility to only install RetroArch, the cores, EmulationStation, and SNESDev with pre-compiled binaries. Since Github has discontinued the download service the option for installing pre-compiled binaried with the RetroPie script was discarded. Take your time and let RetroPie Setup download and compile the programs from their sources!

For more information visit the blog at http://www.petrockblock.com or the repository at https://github.com/petrockblog/RetroPie-Setup. A forum thread about the RetroPie Setup script in the official Raspberry Pi forum can be found at http://www.raspberrypi.org/phpBB3/viewtopic.php?f=35&t=13600.

Wiki

You can find useful information about several components or for several frequently asked questions in the wiki of the RetroPie Script. If you think that there is something missing you are invited to add it to the wiki.

Thanks

This script just simplifies the usage of the great works of many other people that enjoy the spirit of retrogaming. Many thanks go to them!