Please see notes on the “Software” page about expanding the filesystem to utilize the whole SD card. This is not done automatically.

PiTFT Buttons

The four buttons the PiTFT display are mapped to the following (start from left to right):

  1. Exit - Escape (GPIO 17)
  2. Select - Left Control (GPIO 22)
  3. Start - Enter/Return (GPIO 23)
  4. Not Mapped - 4 (GPIO 27)

Connecting to WiFi

Before connecting a WiFi adapter, you'll want to use a USB hub so you can connect a USB keyboard necessary for typing your WiFi password. Then, connect a WiFi adapter into the USB hub.

Go to the RetroPie section in Emulation Station and choose "Configure WiFi". Select "1 Connect to WiFi network" with the Enter key. Use the up and down buttons of the DPad to highlight your network and the Enter key to choose. Type in your WiFi password and use the Enter key to submit. Your Pi's IP address will display in the top of the WiFi Menu. Choose "Cancel" using the Enter key to exit the "Configure WiFi" menu.

Uploading ROMs

You'll need to get the Pi on your WiFi network in order to connect to it. Use your desktop computer and your prefered SFTP client to connect.

  • IP Address - example: 10.1.10.XXX
  • Username: pi
  • Password: raspberry

Go to the following directory to upload ROMs


Upload your ROMs to the proper emulator folder (ie. nes, snes, gb, etc.)

USB Port

The USB port can be used to connect peripheral such as a USB hub, keyboard, WiFi, Bluetooth or audio adapter.

Please note, USB 3.0 hubs can be problematic the Raspberry Pi Zero.

Audio Adapter

A USB Audio Adapter can be used to output audio. We suggest using the one linked in the BOM, as it's proven to work with the Raspberry Pi. There's no need to configure the audio since the ready-to-go PiGRRL Zero image has it preinstalled. 

To change the audio output level, go to the "RetroPie" section in emulation station and select "Configure Audio Settings", then choose "4 Mixer - adjust output volume" using the "enter / return" key (3rd button from left) on the PiTFT. From here, you can use the DPAD up or down  buttons to adjust the audio levels. Press the "exit" button (far left button) on the PiTFT to save and exit "ALSA Mixer".

Exiting a ROM/Game

To quit a game and go back to the Emulation Station screen, press and hold the "Start" and "Select" buttons at the same time.

This guide was first published on May 06, 2016. It was last updated on Mar 07, 2017.

This page (Usage & Extras) was last updated on May 15, 2016.

Text editor powered by tinymce.