A good retro console should disappear into the experience: switch it on, pick up a controller, and play. Building one with a Raspberry Pi is as much about getting the small details right as it is about installing an emulator.
RetroPie brings several emulation tools together behind a controller-friendly interface. Begin with one system and a small selection of homebrew games you are allowed to use. A carefully configured handful is more enjoyable than an enormous library with broken controls.
Choose a compatible board and image
A Pi 4 is a sensible target for this guide. Check RetroPie's current download page for an image explicitly supporting your model. Do not assume a Pi 4 image will boot a Pi 5 just because the newer board is faster; newer hardware may require a different installation path.
You will also need a suitable power supply, microSD card, HDMI cable, display, and USB controller. Use a wired controller for the first setup so Bluetooth pairing does not become another variable. Keep a keyboard nearby for administration.
Build the console before the library
- Download the correct image from the official RetroPie project.
- Use Raspberry Pi Imager's custom-image option to write it to the intended card. Imaging erases that card.
- Connect HDMI and the controller, then boot the Pi.
- Complete the initial input mapping, including the hotkey button.
- Set the appropriate region, keyboard, and network options for your installation.
Follow the on-screen instructions for skipping controls your gamepad does not have. Write down the hotkey combination used to exit a game. It is easy to forget once the keyboard is put away.
Add a game you can legally use
Use a homebrew game or another title you have permission to copy and run. RetroPie does not supply a commercial game collection. Some systems also require BIOS files; those are separate files with their own distribution restrictions.
If you enable SSH through the system's configuration tools, you can transfer a file from your computer with SCP. Replace every uppercase placeholder below with your actual account, host, and supported system directory.
# Run on your computer, using an existing RetroPie ROM directory.
scp ./YOUR_HOMEBREW_GAME.nes YOUR_USER@PI_ADDRESS:~/RetroPie/roms/nes/
Restart EmulationStation through its menu so the library refreshes. If your game is for a different system, use that system's documented directory and file format. Renaming a file extension does not convert a game into another format.
Tune for the screen in front of you
Launch one game and check movement, buttons, sound, pause, and exit. Enable your television's game mode if it has one. Test responsiveness before adding visual shaders: an attractive filter is not worth controls that feel delayed.
Try a second game on the same system before changing global emulator settings. One incompatible title can mislead you into “fixing” a configuration that was otherwise correct. Keep a note of each change so you can return to the previous working state.
Make the console easy to live with
Label the power supply and keep the cable strain away from the Pi's ports. Use the menu's shutdown action and wait for shutdown to finish before removing power. Abrupt power loss can damage filesystem state, particularly while a save is being written.
Copy save files and configuration to another device after an evening of setup. To see the size of the main folders from a terminal on the Pi, use:
du -sh "$HOME/RetroPie/roms"
du -sh /opt/retropie/configs
These commands only report disk usage; they do not create a backup. Keep the game files, save data, and configuration together in your recovery plan.
When a game does not appear
Check its folder, extension, and whether the system needs a BIOS. If the controller works in the menu but not inside a game, inspect that emulator's mapping. If the console behaves unpredictably under load, check power and cooling before assuming the image is broken.
For another satisfying weekend build, try a time-lapse camera. Both projects reward starting with a small, finished result.
Sources and further reading
Researched from the official documentation linked above on September 10, 2026. Setup examples are starting points and have not been hardware-tested by Open Pi. Check your board, OS, and the project’s current instructions before installing.