Frequently Asked Questions

1] Q) Where can I find tutorials since I am totally new to SBCs?

A) If this is something totally new to you our best advice is to first step back, take a deep breath, and don’t just dive in as it could become a little bit confusing. The next step would be to stop by our Youtuber Affiliates page, check out their YouTube channels as they all have various and numerous tutorials on how to get started with RetroPie or even other distro images as all of them (RetroPie, Batocera, Recalbox, OGST, Lakka, etc.) all install the same.

2] Q) Does the image auto expand?

A) Yes, the image is coded so that when you first boot it will start the process for a couple seconds and then you will see it reboot. At that point it should be expanded to the limits of the storage medium be it EMMC or MicroSD. NOTE: If you have both an EMMC and a MicroSD card installed you make see issues with auto expand not working correctly as it will think your microSD is a secondary file system and relabel it 1 from 0.

3] Q) Can I flash the image on EMMC and store ROMs/media on an SD card?

A) Yes. Use similar method to one described on RetroPie forums/wiki.

4] Q) Can I install the ORA RetroPie image to my SD card just like with Raspberry Pi?

A) Yes. The nuts and bolts is that any Single Board Computer (SBC) that can run RetroPie (Raspberry Pis, Banana Pis, Rock64, etc) use what is called a .img file that you can write to a card to boot from. On Windows the preferred method is either Win32DiskImager or Etcher for example. The major difference is that each board uses a different linux distro or else perhaps the same distro (think Debian or Ubuntu) however the driverset and distro framework are custom tailored to the board in question.

5] Q) Can I just drop my various config files and such from a raspberry pi build?

A) NO NO NO. If you so do you will end up with a mixed bag of results. The best suggestion would be to open those config files and ensure that you update the file path from /pi/ to /pigaming/. That is a first step. Please make sure if you request support that you let us know that is what you did and we could POSSIBLY assist from there, but no promises.

6] Q) Does the 8bitdo controllers work?

A) Yes, the BT service is installed and you will need either the Odroid BT module or a generic CIR 4.0 module.

7] Q) How do I use an extra HDD for my ROMs and media?

A) Reference the RetroPie wiki:  Running ROMs from a USB Drive

8] Q) Is there any issues with using Core Override in RA settings?

A) There is a known bug where using this function will cause Save On Exit to stop working therefore we suggest you do not use it at this time. If you do we are not aware of a resolution other than reflashing.

9] Q) Can I use my own splash screen videos?

A) Yes, however you must encode them correctly. (We need to provide basic known working parameters)

10] Q) Can I use the updater in RetroPie Setup like on the Raspberry boards?

A) Yes, however, due to the modifications required for many scripts to work it will hit our GitHub. This means that if a new official RetroPie based update is released we will normally need to test before allowing it to be accessed.

11] Q) I wondered if you are able to install experimental packages on this retropie specific image like you would any other retropie image?

A) We typically have all currently compatible packages installed on the base image. We do this to make life much more simple since the various scripts need changes to work on the XU4 compared to Raspberry boards.

12] Q) why doesn’t “xxxx” not work for me when it does on my Raspberry Pi?

A) The simple answer is this isn’t a raspberry pi. RetroPie focuses mainly on the raspberry boards as that is how it all started. The hardware and Linux OSes are very different (Raspian/Debian vs mainline Ubuntu).

13] Q) Can I use add-ons with Kodi and if so what do I need to do to make them work?

A) The base install of Kodi is on the image however we do not formally support it nor do we support add-on plugins.

14] Q) Does WiFi work?

A) Yes there are various adapters that will work. We are attempting to bake support in for the various adapters sold by AmeriDroid. ETA for this is TBD.

15] Q) the download link seems to be broken when I click on it (I am using windows to download). it brings me to a page where I can not download anything.

A) Don’t use MS Edge.

16] Q). How do I get my PS3 controller to work?

A) one of our members was able to get the controller to work with the following however YMMV depending on which adapters you use:

  • Using pigaming login enter the following via terminal:

sudo apt-get install libc-bin

sudo dpkg –configure -a    (two dashes in a row before configure!)

  • Via RetroPie Setup install the PS3 controller driver


17] Q). Which kernel version of Ubuntu does v1 and v1.1 of the RetroPie build use?

A) 3.10 is what has been used. We are aware that there is nice stability and improvements in the 4.1x kernel however we have decided to wait until 18.01LTS of Ubuntu is released in May/June 2018 before looking to move to the newer kernel.

18] Q). Can I take a backup of my Raspberry Pi RetroPie build and just image it to use with my Odroid?

A) No. The hardware and Linux OSes are very different (Raspian/Debian vs mainline Ubuntu). You can however gather all of your games/media from your Raspberry build and use it since the frontend of the RetroPie build remains for the most part the same.

19] Q) I am seeing weird behavior that others aren’t talking about.

A) Reflash your card. We have seen too many instances where for unexplained reasons the image for people has burned with odd results. Too many variables that could contribute, but many times a reflash does the trick. If not then try to re-download then flash again. This has been the resolution for multiple people.

20] Q). Will there be a RetroPie build for the C2?

A) Possibly eventually however we need a couple trustworthy people to join the dev team to assist that own one.

21] Q). How can I play PC Engine CD based games?

A) If you get .CHD ROMs you don’t need to do any configuration. It just works. But you need to use the lr-beetlefast emulator.

22] Q). How can I move my image from a smaller card to a bigger one?

A) The manual process would be to use the script in the boot dir in the following way:

  • Back up your image, write to the new card
  • Log in as root

type cd /media/boot

type chmod a+x

type chown root:root

type ./

  • You may be informed that it has failed due to “Device or resource busy”. If so reboot and run the script again. In either case you should be informed that the partition has been resized and to reboot. Once you have rebooted:

type df -h

  • You should now see that all available space on the new card is available


23] Q). Will I always be forced to reflash every version that you guys release of RetroPie???

A) We are working toward having updates available via the RetroPie Setup Script for everything however there are certain items that we do not currently have the coding skills to add. An example of this would be adding in the WiFi support for the Odroid adapters. If we can add it via scripting we will. If we can’t then you will need to decide of the new functionality, features, or fixes warrant you making that effort to re-flash.


24] Q). What should I get for a microSD card???

A) You will need a minimum of an 8GB card if you are using an ext HDD for your games/media. This being said there are several card brands/models that can be used. ALWAYS purchase from a proven and legit source and we cannot stress this enough. You should stick more to at least UHS-1 rather than Class 10 as it is will provide solid read operations for the more modern systems. UHS-3 may be considered overkill however if you can get it for a good price faster will always be better overall.  We have a page on our site here (Microsd Cards) with links to cards that are tested and validated that can be purchased on Amazon however as well if you want to purchase elsewhere and want a visual idea then how about some solid suggestions:

25] Q).  I cant get the Outrun clone game to run I try to run it and it just goes back to the game select screen thanks any idea?

A) This port is one that requires the original game files. Visit the Cannonball page on the RetroPie wiki for further details.

26] Q). How can I exit from PPSSPP on the v1 and v1.1 builds?

A) The default emulator for the builds is the standalone due to better performance. If you plug in a keyboard press esc. You can map a different button on the controller as ppsspp’s hotkey per the normal steps that are outlined by the PPSSPP menu system and team.

27] Q). Is Sega Saturn supported on the RetroPie build?

A) As of the beginning of April 2018 we have not had a satisfactory build compile. This being said our plans is to add it as a goal on our Patreon to commission an independent developer on a platform like IndiGoGo perhaps to assist as it is currently apparently outside of our skillset.

28] Q). So with Amiberry is whdload supported and how can I play games on Amiberry in general?

A) Anyone who has issues with WHDLOAD is on their own.  It doesn’t get installed or configured by the Amiberry setup script and from what we have read it’s going to get phased out soon. As for natively running games on Amiberry if somebody uses HDF files (hdd-images) with own uae-config-files from Raspberry images the uae files have to be edited from /pi/ to /pigaming/ paths in those config files. ADF-Files (Amiga-disk-images) run out of the box with Amiberry.

29] Q). Advance MAME ver.1.4 seems have sound problem, the sound will lag and not sync with video?

A) Edit /opt/retropie/configs/mame-advmamea/dvmame-1.4.rc change device_sound sdl <– default is “auto“, change it to “sdl“, then the sound will not lag again however YMMV.

30] Q). Is there a way for me to fix my Xbox 360 Controller(s)? I sometimes experience weird or missing button presses. 

A) One of our members, 許德文, was gracious enough to provide a walkthrough with snips which can be found in our Downloads section here on the website.

31] Q). Is there a way for me to change how long the boxart displays on the Showcase theme? 

A) If you are using our default Showcase theme then there is a built in timer for the boxart to be displayed for 3 seconds. If you are not using boxart then it can give the misguided notion that video snaps are broken. To assist with this if you are not happy with how long the delay is or if you wish to disable it completely you need to modify the main theme.xml file in \etc\emulationstation\themes\showcase\. This snip shows you the </delay> setting which you can set to be for example 1, 2, 3 seconds, etc. If you wish to disable having the boxart show at all then adjust the </showSnapshotDelay> entry to false. IT IS HIGHLY RECOMMENDED THAT BEFORE YOU FIDDLE WITH THIS THEME.XML FILE YOU COPY A BACKUP OF IT!.




32] Q). Is overscan configurable on the XU4?

A) Direct from the manufacturer:  Overscan is not configurable for the XU4, this needs to be solved by your TV settings as the TV is doing the overscan and the SOC is not designed to override this behavior. TV’s, unlike monitors, have “overscan” and are designed to not show the edges of images. Almost every modern TV has a way to disable it. Its called different things by different manufactures. It has been called “1:1 mode”, “just scan”, “no zoom”, and others. Consult your TV manual for details on disabling the mode.