Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

RetroPie

Pi OS (RPI-5)

1 2

install

sudo apt install rpi-imager
wget https://downloads.raspberrypi.com/raspios_lite_arm64/images/raspios_lite_arm64-2025-05-13/2025-05-13-raspios-bookworm-arm64-lite.img.xz
lsblk
sudo rpi-imager --cli --first-run-script ./firstrun.sh 2025-05-13-raspios-bookworm-arm64-lite.img.xz /dev/nvmeXnX
sudo shutdown now

sudo apt update
sudo apt upgrade
sudo raspi-config

Locallisation Options → Locale → Enter <Space> to select/unselect → en_US-UTF-8 UTF-8 → OK → en_US-UTF-8 → OK → Finish.

sudo reboot now

sudo update-locale LANGUAGE="en_US:en"
sudo update-locale LC_ALL=en_US.UTF-8
sudo reboot now

locale

sudo apt install git lsb-release
git clone --depth=1 https://github.com/RetroPie/RetroPie-Setup
cd RetroPie-Setup
chmod +x retropie_setup.sh
sudo ./retropie_setup.sh
  1. Basic Install → Yes
  2. Update → Yes

setup

sudo ~/RetroPie-Setup/retropie_setup.sh
# In EmulationStation, you can clink `<Start>` → RetroPie Configuration → RestroPie Setup
  1. Configuration/tools
    • autostart → Start EmulationStation at boot → OK.
    • bluetooth
      1. Pair and Connect to Bluetooth Device → <your_controller> → OK → DisplayYesNo.
      2. (Optional) Configurate bluetooth connect mode → boot → OK.
    • (Optional) wifi → Connect to WiFi network → <your_wifi> → Entry <your_wifipasswd> → Ok.
    • (Optional) samba
      1. Install RetroPie Samba shares → Ok.
      2. Manually edit /etc/samba/smb.conf → workgroup = SMBGPRP.
      3. Restart Samba service.
      4. Default Samba Shares and paths:
        • roms, /home/user/RetroPie/roms
        • bios, /home/user/RetroPie/BIOS
        • configs, /opt/retropie/configs
        • splashscreens /home/user/RetroPie/splashscreens
  2. Perform reboot

GPi CASE 2

setup

3 4

  1. Connect to a keyboard.
  2. → RetroPie (Configuration)
  3. On PC, connect with: 
    host `retropie` (or ip-address)
port `22`
username `pi`
password `raspberry`

optional

Bluetooth adapter

5

sudo apt install bluetooth pi-bluetooth bluez
sudo vim /boot/firmware/config.txt

# Add on bottom
[all]
dtoverlay=disable-bt

sudo reboot

Enable Xbox controller adapter

6

git clone --depth=1 https://github.com/medusalix/xow
cd xow
make BUILD=RELEASE
sudo make install
sudo apt install cabextract
chmod +x ./firmware.sh
sudo ./firmware.sh
sudo systemctl enable --now xow
sudo systemctl status xow
# sudo systemctl stop xow
# sudo systemctl disable xow
# sudo make uninstall

Enable Pegasus Frontend

7

  1. RetroPie (Configuration) → RetroPie Setup → Configuration/tools.
    1. Manage packages → Manage experimental packages → pegasus-fe → Install from pre-compiled binary.
    2. autostart → Manally edit /opt/retropie/configs/all/autostart.sh → pegasus-fe.
  2. Reboot.

Emulator Löve (Experimental)

8 9

  1. RetroPie (Configuration) → RetroPie Setup → Manage packages → Manage optional packages → love-0.10.2 or love.
  2. Add <game>.love <path_to>/roms/love/.

usage

  1. Configure keymap: <Start> → Main Menu → Configure Input → Hold a key on controller to set.
  2. Refresh roms: <Start> → Main Menu → Quit → Restart EmulationStation → Game listing will be refreshing.

reference

cross-reference

  1. gpi-case-2.md
  2. raspberry-pi-os.md

retropie

  1. Configure_OS.md ↩

  2. Install_RetroPie.md ↩

  3. Retro Gaming With RetroPie, GPi CASE 2, and a Raspberry Pi ↩

  4. RetroPie - SSH ↩

  5. Bluetooth on the Raspberry ↩

  6. xow ↩

  7. Pegasus Docs - Platform Notes: Raspberry ↩

  8. RetroPie Docs - Love ↩

  9. PyGame LÖVE (love2d) in RecalBox ↩