RetroPie is now installing. Using the second option to install is usually faster on the newer Pi models and you end up with the same stuff, but I trust Option 1 and I'll be using Option 1. The installation should take about 15 minutes. First, install Ubuntu (16.04 LTS or later) or a related Debian based distro such as Linux Mint 17 / 18. ISO images can be used to create a bootable DVD or a USB stick.
Retropie on Debian/Ubuntu/Mint
A guide to build the RetroPie setup on Ubuntu (16.04 LTS or later) x86 and Debian based distros.
Installation
First, install Ubuntu (16.04 LTS or later) or a related Debian based distro such as Linux Mint 18 / 19. ISO images can be used to create a bootable DVD or a USB stick.http://www.ubuntu.com/download/desktop Remington serial number dates.
To run RetroPie-Setup, you must be a member of the group root/admin.
Download RetroPie
Update and upgrade the existing APT packages:
Install the needed packages for the RetroPie setup script:
NOTE: if you get any errors about any package not being found and you're using Ubuntu, make sure the
universe
APT repository has been added and enabled on the system by running sudo add-apt-repository universe
and then starting again with the previous step. Download the latest RetroPie setup script:
Enter the folder with the setup script:
The script is executed with:
The screen should look like/similar this at this point:
Install RetroPie
Basic Install
This will install the main packages which are equivalent to what is provided with the RetroPie SD image. Note that this will be the 32-bit version of RetroPie. That means that some emulators such as Daphne (Dragon's Lair) will not work out of the box on this version. That is because Daphne and a few other emulators only have a 64-bit version released for use while this install is for the 32-bit CPU family.
Now, you have to copy your rom files into the correct associated rom directories. If you followed the steps above the main directory for all roms is
~/RetroPie/roms
(or /home/pi/RetroPie/roms
, which is the same here). In this directory there is a sub-directory for every supported emulated system, e.g., NES, SNES, Sega Megadrive, etc. Attention has to be taken for the extensions of the rom files. Some emulators use .zip while some use a custom file extension associated with the emulator in question. For example the Atari 2600 emulator may use .a26, .bin, and .rom.
All the information needed for each system is detailed in this wiki. See the wiki home page or sidebar for systems.
Configure RetroPie
EmulationStation can be run from the terminal by typing
emulationstation
in the terminal.You can go into Setup / Configuration and enable autostart as you like.
FAQ
Emulationstation hangs if shutdown/restart was selected
It is not possible to restart/shutdown if a sudo requests a password. To disable sudo password request add the line
at the end of
/etc/sudoers
. Replace <user> with the name of your current user.Cannot Install PS3 driver
Ubuntu has an builtin PS3 bluetooth driver. There is no need to install sixad. Make your bluetooth dongle discoverable. Connect your controller over usb. Now open 'bluetooth system settings/add device'. Select PS3 controller and click ok. Your controller should pair now if you press PS button.
sidenote: https://retropie.org.uk/forum/topic/2736/ubuntu-16-04-install-genuine-ps3-controller-issue
Screen blanks after some minutes
Open Ubuntu system settings menu disable screensaver and screen lock timeouts.
Ubuntu does not autologin
Open Ubuntu system settings menu and select user accounts. Enable autologin for current user.
How to setup a splashscreen
Use Plymouth to setup a splash screen. See the Plymouth Ubuntu wiki or use this simple ES theme.
My NUC or Intel Baytrail/Braswell powered device hangs
The default kernel 4.1 of Ubuntu 15.10 tends to hang. It is a know bug:https://bugs.freedesktop.org/show_bug.cgi?id=91629
Update to higher kernel version solves this problem:http://sourcedigit.com/18333-how-to-install-linux-kernel-4-3-3-on-ubuntu-15-10-ubuntu-15-04/
No audio
Open Ubuntu System Settings menu and select correct audio output device.
No HDMI audio
Ubuntu 16.04 uses PulseAudio 8 which has issues with HDMI if you suspend your device or change display resolutions at runtime. This problem will be solved with Ubuntu 16.10 and PulseAudio 9. You can disable PulseAudio auto output selection. Open
/etc/pulse/default.pa
and comment out the line:https://bugs.freedesktop.org/show_bug.cgi?id=93946#c36
No audio in Mupen64Plus
EmulationStation's use of PulseAudio will conflict with the SDL driver in Mupen64Plus, disabling sound in N64 games. If you are using lr-Mupen64plus, you will not have this conflict.
From a terminal:
Example output:
Make a note of which card and device you use for audio. For example, for HDMI audio, consider the line
card 0: PCH [HDA Intel PCH], device 3: HDMI 0 [HDMI 0]
. In this case, we would want card 0 and device 3.Create the file
/etc/asound.conf
with the contents:Make sure to change the values of card and device to the values found by running
aplay -l
above.Install Retropie On Ubuntu 18.04
The SDL driver in Mupen64Plus will now use the proper audio device, but it will still conflict with PulseAudio in EmulationStation. Open
/opt/retropie/emulators/mupen64plus/bin/mupen64plus.sh
in your favorite editor. Find the following lines at the bottom of the file:https://businessnew869.weebly.com/download-intel-turbo-boost.html. https://businessnew869.weebly.com/blog/mugen-download-11. Change them to:
This will stop PulseAudio from running while Mupen64Plus is running, but turn it back on when you quit it.
XBOX 360 Controller mappings not working
The X86 version of Retropie install does not have the xboxdrv installed correctly. Please launch Retropie-Setup Manage Packages - Drivers and install xboxdrv and remap your inputs.
How do I map controls to Dolphin?
Dolphin controls must currently be mapped via the GUI. You will need to drop down into terminal mode press F4 on your keyboard if you are currently in emulation station, hit the unity button and search for terminal. Click to launch. Change to the Dolphin directory
From there there graphical client will launch and you can bind your controller in the Dolphin Interface as well as change settings.
Start+Select does not exit Dolphin
Dolphin is not a libretro emulator. Currently exit for Dolphin is hard mapped to Alt + F4 You can manually exit via your keyboard, and come back to emulation station.To map a button on your controller to exit Dolphin you will need to launch via the gui method above. Once in the menu navigate to Hotkey Behavior.
Switch the device indicator to your controllerselect the exit function and map a button like select to this function.You will also need to configure in the graphics window to always force window on top and to hide mouse/cursor
Switch the device indicator to your controllerselect the exit function and map a button like select to this function.You will also need to configure in the graphics window to always force window on top and to hide mouse/cursor
Now enter back into emulationstation mode and launch a dolphin game from the gamecube menupress x when the game is startingSelect Dolphin-Gui instead of dolphin as the runcommand default emulator.Launch gameYou will now be able to exit back to emulationstation with that button you mapped.
How To Install Retropie On Ubuntu
SteamOS hack to allow installation
While SteamOS is not based on Ubuntu 16.04 it is based on Debian 8 which is supported.Currently you can install it and it will set everything up properly. EmulationStation has issues launchingroms just like through a manual installation. However the samba share setup and all other parts of RetroPieappear to function normally.
To start follow the same instructions of doing a git clone of the RetroPie repo. Then you have to edit
In the get_os_version() function the work-around is to change:
To
This will obviously override any platform checking done by the script and is very hacky, but it will let the retropie setup continue properly until actual support exists
How do I get latest graphics drivers?
Install hardware enablement stack (HWE) to get kernels and MESA packages from newer ubuntu versions.