RetroPie Project SD-card Image V2.3

Size1.2 GB
Create Date05/31/2014
Last Updated07/21/2014

This is an SD-card image with a ready-to-go RetroPie installation. It needs an SD-card with at least 4 GB space.

As a first alternative, you can download the image via BitTorrent Sync. The secret is BTPRFQU2LYC4IWTQKUEDYBUNGKZ4H3MY6 You might find that using this way for downloading is faster than the direct download.
As a second alternative you could use the mirror.
The SHA1 sum of the download is


The default user/password that comes with Raspbian is used: The username is "pi", the password is "raspberry".

If you would like to access the RPi as root, you can use the username "root", together with the password "raspberry".

How to Install the Image

Basically, you just have to extract and copy the image to an SD card (at least 4 GB large) in the same way you install the official Raspbian image. A tutorial about this that is written by the RPi community can be found here. If you use a Linux platform or a Mac, you can use, e.g.,  the following instructions:

  1. Check file integrity via
  2. Unzip with

    or with any archive program, e.g., 7-ZIP.

  3. Put the SD card into you RPi, e.g., with the "dd" command or Win32DiskImage, start it. The front-end "Emulation Station" starts automatically.
  4. If your SD card is larger than 4 GB, you need to expand the root file system in order to use the whole SD catrd. Go into the shell by pressing F4. Run
    sudo raspi-config

    and choose "expand root fs" from the menu. You need to restart your RPi afterwards.

  5. You need to copy ROMs and, if you want to use it, a NeoGeo bios to the corresponding roms and bios folders.
  6. Enjoy your RetroPie installation :-) If you have questions, comments, or suggestions feel free to post them in the comments, the forum, or at Github.

Change log

The complete commit history of the RetroPie Script can be found here.

Version 2.3

  • Several bug fixes

Version 2.2

  • Added Mednafen PCE Fast
  • Fixed configurations for sega32x, segacd
  • Updated SAMBA configuration
  • Fixed imame4all-rpi rom dir configuration
  • Updated Python help scripts

Version 2.1

  • Fixed black screen when exiting to console
  • Fixed Doom Shareware starter
  • Removed hidden meta data files from FBA and Megadrive rome directory

Version 2.0

  • Reorganized folder structure (root dir is now /opt/retropie)
  • Complete rebuild of all binaries with latest versions
  • EmulationStation 2 as new front-end
  • Added MSX emulator OpenMSX
  • Refactored RetroPie-Setup Script with command line capabilities

Version 1.10.1

  • Updated Raspbian to the latest packages
  • Updated the default splash screen
  • Added x86 emulator FastDosbox

Version 1.9.1

  • Fixed "freezing" bug

Version 1.9

  • Added emulator Mame4All-RPi
  • Added emulator Mupen64Plus-RPi
  • Added splash screen configuration to RetroPie Setup Script
  • Added configuration menu for RetroArch NetPlay to RetroPie Setup Script
  • Enhanced debug log functionality of RetroPie Setup Script

Version 1.8.1

  • Added freezing fix for Emulation Station
  • Re-added source-based installation function for PC-Engine Libretro core

Version 1.8

  • Added (Libretro based) Genesis emulator Picodrive
  • Added emulator PiFBA
  • Updated Emulation Station, x86 emulator, and RetroArch to latest release

Version 1.7

  • Added ES-Config
  • Added Atari 2600 emulator Stella
  • Updated Emulation Station, x86 emulator to latest releases

Version 1.6.1

  • Fixed GPSP binary

Version 1.6

  • Added emulator Basilisk II
  • Added Dispmanx
  • Updated every installable component
  • Enhanced script for switching between resolutions

Version 1.5

  • Added emulator gpSP
  • Added emulator SNES9X-RPi
  • Added emulator PiSNES
  • Added GPIO gamepad drivers
  • Updated Emulation Station
  • Updated rpix86

Version 1.4.1

  • Updated Emulation Station
  • Updated rpix86

Version 1.4

  • Added system-dependent change of HDMI video resolution for increased performance for RetroArch-based emulators.
  • Added automatic USB ROM-copy service
  • Added x86 emulator rpix86
  • Added Apple ][ emulator Linapple
  • Enhanced themes

Version 1.3.1

  • Minor changes in the file organization

Version 1.3

  • Added NXEngine / Cavestory
  • Updated DGEN to version 1.32
  • Enhanced pre-defined RetroArch input configuration

Version 1.2.1

  •  Resized partition so that the image fits on 4 GB cards

Version 1.2

  • Added Intellivision emulator
  • Added SAMBA share installation and configuration
  • Used binaries-based setup for generating the SD-card image
  • Updated themes

Version 1.1

  • Added AdvMAME emulator
  • (Re-)added Genesis-GX RetroArch core
  • Added Final Burn Alpha emulator




  1. Magnet link?

  2. Link doesn't work, managed to download a .sync file but even after renaming it to .zip it doesn't work :(

  3. Is 2.1 working / downloadable now?

  4. What did you do to fix the black screen when exiting to console in 2.1?

  5. AWESOME image mate. Will donate something for sure soon. This is great software!

    Trying to get controller to work and trying to logon as root, but is the password changed?
    I'm trying to logon as root so I have rights to edit /opt/retropie/configs/all

    "If you would like to access the RPi as root, you can use the username "root", together with the password "raspberry".

    I try it using:

    su root


    Doesnt work though: "su authentication failure".

    Hope you can help me out. Thanks!

    • Might be that version 2.1 does not have the root account activated. You could do that yourself by calling passwd in the console.

      Version 2.2 of the RetroPie image is uploading right now and has this included for sure.

      • Thanks you both! It's working now :).

        Did the sudo -s to get to root account and then passwd to change the password.

        Now for getting the mame set roms to work :D

    • Just type "sudo -s" to access root.

  6. Everything works great thanks though if you try to autoscrape it fails everytime and freezes the rpi.

    Also the cmd likes to resize itself but that was an easy fix. Any way to do the scraper without manually goung through all 2000 games (auto)

  7. Can't download :( Mirror says been downloaded too much and torrent - I can't seem to download the client from the website. Will keep trying!

  8. Arrierito Soy

    Hello! I installed the image sd 2.3 and the xbox controller doesn´t work with mame roms, however, it works with the other systems (genesis, neogeo, snes). I am newbie;-) Can anyone help, please? Thank you very much.

    • I'm having the same issue

      • Arrierito Soy

        Solved! It was simple but novices little things cost us a lot;-)

        You have to enter the Mame menu by pressing "TAB" and set the command from there.

Leave a Reply