Retropie on Debian/Ubuntu/Mint
- Load your core by clicking on the first tab. Scroll down until you reach the desired Core. We will use Nestopia for now. Don't forget - Content must be compatible with the matched Core.
- Retro gaming on Raspberry Pi devices is incredibly simple no matter which OS you choose. From this Retropie Recalbox comparison, it's clear that each distro despite differences doesn't stray from the core mission of gaming on the Pi. Both systems come with almost the same features, and both are built on Retroarch and Emulationstation.
Retroroller is a pre-built image for the ODROID-GO Advance that provides RetroArch 32bit and 64bit on CrashOverride's one and only stock image. Among other tweaks, a custom kernel is integrated that supports sleep. The idea with this image is to be able to update via a rolling package release instead.
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
Limited time offer! Tableau Desktop Spring Training Pass. Unlimited 90-day access to Tableau's live, virtual instructor-led training courses. Give us six weeks and we'll get you ready to certify This all-inclusive bundle includes six weeks of interactive training, prescriptive lessons, and up to two attempts at your Tableau Desktop Specialist certification exam —everything you need to confidently certify. Build your resume, advance your career and validate your Tableau knowledge and skills with Tableau Desktop and Server certification. For all preparing for the Tableau Desktop Specialist certification. Mentored certification preparation to fast-track your journey of Specialist Certification.
To run RetroPie-Setup, you must be a member of the group root/admin.
Download RetroPie
Retroarch Docker Windows
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 then appear like this:
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.
Retroarch Docker Tutorial
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 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.
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:
Change them to:
This will stop PulseAudio from running while Mupen64Plus is running, but turn it back on when you quit it. Tableau prep 2020.
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.
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.
First we need to know where the HDMI output is on our hardware. Let's use the aplay command:
This will return something like the following lines: Amazon prime master movie.
In my hardware configuration I found that my integrated onboard audio card '0' uses the '3'rd device as HDMI out.
In my 'retroarch.cfg' file I wrote the following (notice the mysterious 'audio_device' parameter):
To run RetroPie-Setup, you must be a member of the group root/admin.
Download RetroPie
Retroarch Docker Windows
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 then appear like this:
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.
Retroarch Docker Tutorial
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 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.
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:
Change them to:
This will stop PulseAudio from running while Mupen64Plus is running, but turn it back on when you quit it. Tableau prep 2020.
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.
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.
First we need to know where the HDMI output is on our hardware. Let's use the aplay command:
This will return something like the following lines: Amazon prime master movie.
In my hardware configuration I found that my integrated onboard audio card '0' uses the '3'rd device as HDMI out.
In my 'retroarch.cfg' file I wrote the following (notice the mysterious 'audio_device' parameter):
I noticed that the out rate parameter at 44100 is mandatory. With another values (i.e. 22100) the audio was not working.
The only issue is that when the emulator runs at < 100% the audio is glitchy. I can try disabling rewind: it seems emulation runs faster this way.
Some user reported that this problem doesn't exist using SDL (not yet tried).
Some reference:
https://github.com/petrockblog/RetroPie-Setup/wiki/Sound-Issues