Skip to content

Arch Linux

HerbFargus edited this page Jul 9, 2017 · 1 revision

Retropie - Arch Linux Flavor

This tutorial was written by r4 ( and is now adapted to work with AUR4 and apacman script.


A guide to build the retropie setup on Arch Linux. This guide is not all encompassing. It is merely a basic setup to build a similar environment offered on the official Retropie install script.


Section 1: AUR tools

Install apacman

tar xzf apacman.tar.gz
cd apacman
makepkg -si

If makepkg reports an error, make sure you have base-devel installed:

pacman -Sv base-devel

Section 2: Install retroarch:

First we need a special build of sdl2 to make Retroarch and EmulationStation work the best with RPi/RPi2. Then next we can proceed on installing retroarch.

apacman -S sdl2-rbp-bin
apacman -S retroarch-rbp-git

Section 2.1. Configuration

Copy skeleton configuration file located at /etc/retroarch.cfg to ~/.retroarch.cfg

cp /etc/retroarch.cfg ~/.retroarch.cfg

With your working joystick, configure your controller with the following command.

retroarch-joyconfig >> ~/.retroarch.cfg

Note: Ensuring your joystick is working will not be covered in this guide as this falls out of scope and there are plenty of other resources to help with this.

Consult for more information.

Section 3: Install Emulators

There are several emulators for retroarch. You can get a list of them by issuing the command below. Install whatever is necessary.

apacman -Ss libretro

Note: Some emulators may not work or may require manual building by downloading the associated tarball and issuing the command:

makepkg -Acsi

Section 4: Install ROMs

Make directory and install ROMs to ~/roms/.


mkdir -p ~/roms/snes
cp /path/to/roms/* ~/roms/snes/

Section 5: Install EmulationStation:

EmulationStation is found in the AUR.

apacman -S emulationstation-git

5.1 Configuration

Taken from

~/.emulationstation/es_systems.cfg: When first run, an example systems configuration file will be created at $HOME/.emulationstation/es_systems.cfg. This example has some comments explaining how to write the configuration file, and an example RetroArch launch command. See the "Writing an es_systems.cfg" section for more information.

~/.emulationstation/es_input.cfg: When you first start EmulationStation, you will be prompted to configure any input devices you wish to use. The process is thus:

Press a button on any device you wish to use. This includes the keyboard. If you are unable to configure a device, hold a button on the first device to continue to step 2.

Press the displayed input for each device in sequence. You will be prompted for Up, Down, Left, Right, A (Select), B (Back), Menu, Select (fast select), PageUp, and PageDown. If your controller doesn't have enough buttons to map PageUp/PageDown, it will be skipped.

Your config will be saved to ~/.emulationstation/es_input.cfg. If you wish to reconfigure, just delete this file.

NOTE: If ~/.emulationstation/es_input.cfg is present but does not contain any available joysticks or a keyboard, an emergency default keyboard mapping will be provided.

As long as ES hasn't frozen, you can always press F4 to close the application.

5.2 Themes

With this you'll get the Simple theme, one of the most complete themes out there.

mkdir -p ~/.emulationstation/themes
unzip -d ~/.emulationstation/themes

Consult for more information.

5.3 Scraper

The ES-Scraper project is no more compatible with Emulation Station since es_systems.cfg now is an XML file.

Section 6: Launch EmulationStation at login

Issue the command below to ensure EmulationStation starts at login.

echo 'emulationstation' >> ~/.bash_profile

or if you're using ZSH

echo 'emulationstation' >> ~/.zlogin

Note: The single quotes around the string being echoed are important!

Section 7: Auto login at boot

Taken from

systemctl edit getty@tty1

and then write/paste this inside

ExecStart=-/sbin/agetty --autologin <username> --noclear %I 38400 linux

save the file and reboot.

Now you should have a working environment similar to what retropie offers but in Arch Linux. Enjoy! :)

Wiki Home Page

Getting Started



Advanced Configuration




Clone this wiki locally
You can’t perform that action at this time.