Back to rankings

RetroPie/RetroPie-Setup

Shell

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

raspberry-pipiretrogamingemulation
Star Growth
Stars
10.4k
Forks
1.4k
Weekly Growth
Issues
47
5k10k
Sep 2012Apr 2017Dec 2021Jul 2026
README

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:

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

Then you can download the latest RetroPie setup script with:

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

The script is executed with:

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!

Related repositories
home-assistant/core

:house_with_garden: Open source home automation that puts local control and privacy first.

PythonPyPIApache License 2.0pythonhome-automation
home-assistant.io
89.4k38.1k
pi-hole/pi-hole

A black hole for Internet advertisements

ShellOtherpi-holead-blocker
pi-hole.net
60k3.3k
gogs/gogs

The painless way to host your own Git service

GoGo ModulesMIT Licensegogsgo
gogs.io
47.7k5.1k
raysan5/raylib

A simple and easy-to-use library to enjoy videogames programming

Czlib Licenseraylibc
raylib.com
34k3.2k
hwdsl2/setup-ipsec-vpn

Set up your own IPsec VPN server in just a few minutes, with IPsec/L2TP, Cisco IPsec and IKEv2. Supports Ubuntu, Debian, CentOS/RHEL, Alpine Linux and Raspberry Pi OS. Includes client config and management scripts.

ShellOthervpnipsec
28.2k6.5k
MagicMirrorOrg/MagicMirror

MagicMirror² is an open source modular smart mirror platform. With a growing list of installable modules, the MagicMirror² allows you to convert your hallway or bathroom mirror into your personal assistant.

JavaScriptnpmMIT Licensemagicmirrorjavascript
magicmirror.builders
23.7k4.5k
navidrome/navidrome

🎧 Your Personal Streaming Service

GoGo ModulesGNU General Public License v3.0musicsubsonic-server
navidrome.org
22.4k1.6k
mikeroyal/Self-Hosting-Guide

Self-Hosting Guide. Learn all about locally hosting (on premises & private web servers) and managing software applications by yourself or your organization. Including Cloud, LLMs, WireGuard, Automation, Home Assistant, and Networking.

Dockerfileself-hostedselfhosted
22k1.1k
jarun/nnn

n³ The unorthodox terminal file manager

CBSD 2-Clause "Simplified" Licensefile-managerdisk-usage
21.7k811
microsoft/IoT-For-Beginners

12 Weeks, 24 Lessons, IoT for All!

Jupyter NotebookMIT Licenseiotmicrocontroller
17k2.9k
thibmaek/awesome-raspberry-pi

📝 A curated list of awesome Raspberry Pi tools, projects, images and resources

ShellOtherawesomeraspberry-pi
16.6k1.1k
alphacep/vosk-api

Offline speech recognition API for Android, iOS, Raspberry Pi and servers with Python, Java, C# and Node

Jupyter NotebookApache License 2.0speech-recognitionasr
15k1.7k