Manual Installation - eddywebs/RetroPie-Setup GitHub Wiki
Install Raspbian:
You can download a fresh Raspbian Image from here. The Raspbian image can be installed the same way as the RetroPie image as described here).
Once your Image has been installed you need to expand your file system.
Expand File System
This allows your SD card to use all its storage rather than the small partition it was released with.
From the terminal type
sudo raspi-config
(as a first step you can optionally change the boot options in option 3 to console autologin so you don't have to keep going through the desktop software to get to the terminal.)
You will get this message:
Select finish
And then reboot your raspberry pi
You can check your free disk space with
df -h
/dev/root is your main partition. Then, I would recommend to update and upgrade the existing APT packages with
sudo apt-get update && sudo apt-get upgrade
After that, we install the needed packages for the RetroPie setup script:
sudo apt-get install -y git dialog
Then we 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
chmod +x retropie_setup.sh
sudo ./retropie_setup.sh
The screen should look like this then:
Verify Locale Settings
Most of the install scripts will attempt to install a variety of packages and libraries that each emulator requires. These installations will fail if your system local settings are invalid. You can easily verify this by executing locale
command. A valid locale will return values set for all options, such as in the example below.
LANG=en_US.UTF-8
LANGUAGE=en_US:en
LC_CTYPE="en_US.UTF-8"
LC_NUMERIC="en_US.UTF-8"
LC_TIME="en_US.UTF-8"
LC_COLLATE="en_US.UTF-8"
LC_MONETARY="en_US.UTF-8"
LC_MESSAGES="en_US.UTF-8"
LC_PAPER="en_US.UTF-8"
LC_NAME="en_US.UTF-8"
LC_ADDRESS="en_US.UTF-8"
LC_TELEPHONE="en_US.UTF-8"
LC_MEASUREMENT="en_US.UTF-8"
LC_IDENTIFICATION="en_US.UTF-8"
LC_ALL=en_US.UTF-8
If any of the above configuration lines are unset (particularly LANG, LANGUAGE, and LC_ALL), you should set them before installing RetroPie. The easiest way to set each item is to use the update-locale
command, such as $ sudo update-locale LC_ALL="en_US.UTF-8"
.
Users can also set the local through the raspi-config
tool.
Full Install
For the first installation, we choose the binaries-based installation, which takes 15-30 minutes. We start the installation simply by pressing ENTER.
Now, you have to copy your rom files into the ROMs directory. If you followed the steps above the main directory for all ROMs is ~/RetroPie/roms (or /home/pi/RetroPie/roms, which is the same here). In this directory there is a subdirectory for every emulated system, e.g., nes, snes, megadrive. Attention has to be taken for the extensions of the ROM files. All the information needed for each system is detailed in this wiki (see wiki home page or sidebar for systems)
EmulationStation can be run from the terminal by typing emulationstation
in the terminal
Partial Install
Say you don't want to bloat your system with all of RetroPie- you also have the option to only install the emulators you want.
EmulationStation
First you you need to install EmulationStation from the retopie setup script from option 5. It will be near the bottom of the list
The you can auto-start emulationstation from option 3 of the retropie setup script (if you want your system to boot into emulationstation)
You'll then need to install a theme which can be installed from option 3 of the retropie setup script (carbon will work best as the default theme)
RetroArch
You need to install Retroarch if you want most of the emulators to work. It can be installed from option 5 of the retropie setup script
Emulators
You can install the emulators that you want from option 5 of the retropie setup script, you can also install other emulators from the experimental menu.
Samba Roms
If you want to use samba shares you can set them up from option 3 of the retropie setup script.