Gitpedia

RetroPie Setup

Shell script to set up a Raspberry Pi/Odroid/PC with RetroArch emulator and various cores

From RetroPie·Updated May 30, 2026·View on GitHub·

Shell script to setup the Raspberry Pi, Vero4K, 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 https://retropie.org.uk. The project is written primarily in Shell, distributed under the Other license, first published in 2012. It has gained significant community traction with 10,379 stars and 1,403 forks on GitHub. Key topics include: emulation, pi, raspberry-pi, retrogaming.

Latest release: 4.8 RetroPie-Setup Script version 4.8
March 14, 2022View Changelog →

RetroPie-Setup

General Usage

Shell script to setup the Raspberry Pi, Vero4K, 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 https://retropie.org.uk.

This script is designed for use on Raspberry Pi OS (previously called Raspbian) on the Raspberry Pi, OSMC on the Vero4K 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:

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

Then you can download the latest RetroPie setup script with:

shell
cd git clone --depth=1 https://github.com/RetroPie/RetroPie-Setup.git

The script is executed with:

shell
cd RetroPie-Setup sudo ./retropie_setup.sh

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 site at https://retropie.org.uk or the repository at https://github.com/RetroPie/RetroPie-Setup.

Docs

You can find useful information about several components and answers to frequently asked questions in the RetroPie Docs. If you think that there is something missing, you are invited to submit a pull request to the RetroPie-Docs repository.

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!

Contributors

Showing top 12 contributors by commit count.

View all contributors on GitHub →

This article is auto-generated from RetroPie/RetroPie-Setup via the GitHub API.Last fetched: 5/31/2026