Shell script to setup Raspberry Pi (TM) with RetroArch emulator and various cores
Shell Python
Pull request Compare This branch is 20 commits behind RetroPie:master.


General Usage

Shell script to setup the Raspberry Pi, ODroid-C1 or a PC running Ubuntu with many emulators and games, using EmulationStation as the graphical front end. Bootable pre-made images for the Raspberry Pi are available for those that want a ready to go system, downloadable from the releases section of GitHub or via our website at

This script is designed for use on Raspbian on the Rasperry Pi, or Ubuntu on the ODroid-C1 or a PC.

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

sudo apt-get update
sudo apt-get dist-upgrade
sudo apt-get install git

Then you can download the latest RetroPie setup script with

git clone --depth=1

The script is executed with

cd RetroPie-Setup
sudo ./

When you first run the script it may install some additional packages that are needed.

Binaries and Sources

On the Raspberry Pi, RetroPie Setup offers the possibility to install from binaries or source. For other supported platforms only a source install is available. Installing from binary is recommended on a Raspberry Pi as building everything from source can take a long time.

For more information visit the blog at or the repository at


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.


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!