Skip to content
Shell script to setup Raspberry Pi (TM) with RetroArch emulator and various cores
Shell Python
Branch: master
Clone or download
Pull request Compare This branch is 3697 commits behind RetroPie:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


General Usage

Shell script to setup the Raspberry Pi 1 / 2 with several emulators, various cores, and EmulationStation as graphical front end. Bootable pre-made images are available from for those that want a ready to go system.

This script is designed for use on the Raspbian Wheezy distribution. It has some support for Raspbian Jessie / OSMC but requires building from source - and there may be problems with modules. Before using the script, please **make sure that you have run the raspi-config script to extend your root file system **. 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 is installed:

sudo apt-get update
sudo apt-get 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. Note that you might need to reboot your Raspberry, if your firmware was updated during the installation process.

Binaries and Sources

RetroPie Setup offers the possibility to install from binaries or build from source. For most users installing from binary should suffice - but for the very latest versions of some software building from source may be preferred. Building from source can take more than a day on a Raspberry Pi.

For more information visit the blog at or the repository at A forum thread about the RetroPie Setup script in the official Raspberry Pi forum can be found 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!

You can’t perform that action at this time.