Much of this guide is paraphrasing the RetroPie wiki.Each section has links to the respctive retropie wiki page. For a much more in-depth guide on using RetroPie visit https:\/\/github.com\/RetroPie\/RetroPie-Setup\/wiki<\/a>.<\/p>\n Any controls specified in this document only apply when using the default button configuration. Buttons & combinations of, will be denoted by encompassing square brackets.<\/p>\n First boot<\/span><\/p>\n In the box Bluetooth connection setup SSH Per game configuration Retroberry.tk In the box with your console will be a charging cable and a compatible HDMI cable. For first boot we recommend connecting the Retroberry Zero to a power source and display using the provided cables. If you want to connect to WIFI you must\u00a0also connect a Bluetooth or USB keyboard to complete the setup process. Once the following setup process is complete you may disconnect any unneeded peripherals and play.<\/p>\n Whilst setting the device up a keyboard will be required and we recommend connecting the device to a HDMI display. A micro USB adapter and mini HDMI cable are provided. Once connected turn the device on.<\/p>\n Once the boot process is complete, you will notice you only have one menu option. Settings. Thats because you need to upload some ROM\u2019s before console options appear in the menu. But before that there is a small bit of configuration to do.<\/p>\n The first thing to do is pair the RBZ with any Bluetooth devices you need for setup i.e. keyboard. See the \u2018Bluetooth connection setup\u2019 section of this guide for full instructions. Now you should set up the WIFI, it doesnt need to be on all the time but its useful for scraping cover art and transferring roms wirelessly. See the \u2018WIFI connection setup\u2019 section of this guide for full instructions.<\/p>\n Once all of the prior steps are complete, if you would like, you can remove the USB keyboard and HDMI display.<\/p>\n After that you are going to want to upload some ROMs and get playing. To do that use one of the methods in the \u2018uploading roms\u2019 section of this guide. Then restart emulationstation. Now once you get to the main menu you will see options for consoles. When selected your roms for that device will be listed.<\/p>\n Please note: Connection to an external monitor is advised and a keyboard wired or otherwise is required to complete this setup. Bluetooth can be set up in the main settings menu, under Bluetooth. To pair with a device select pair in this menu, then it will ask for an authentication style. Try the first, then the second, and so on, one of them will work.<\/p>\n Once paired, when booting the Retroberry Zero will automatically https:\/\/github.com\/RetroPie\/RetroPie-Setup\/wiki\/Wifi<\/p>\n Please note: A keyboard, wired or otherwise, is required to complete this setup. Connection to an external monitor is advised.<\/p>\n WIFI can be set up in two ways.<\/p>\n The graphical interface, available in the main settings menu under WIFI. Then select connect to a wifi network. Select your access point and enter your credentials. Press ‘ok’. It will notify you that it is connecting and then take you back to the first screen. To confirm you are connected your ip should be displayed in the top left, if you plan on using ssh or sftp now would be a good time to note it down. If it is connected, hit [B] then [A] to exit.<\/p>\n Alternatively you can manually edit the \/etc\/network\/interfaces file. See manual WIFI setup in the advanced section.<\/p>\n ROMs must be transfered to console-specific folders on the SD card, located at \/home\/pi\/Retropie\/roms\/(Retro console name). SD transfer is the simplest method. SFTP transfer, achieved using a network connection. We recommend plugging the device into a power supply when transferring allot of data . First the RBZ must have FTP transfer enabled (disabled by default for security). Next acquire the IP address of the RBZ, this can be seen on the WIFI settings menu.<\/p>\n Then using your file browser select connect to server and when prompted for an address type sftp:\/\/xxx.xxx.xx.xx replace the xs with the address of the pi. You will then be prompted for the user and password and if you haven’t altered these it will be (pi) user (retroberry) password.<\/p>\n The file browser will then open the home directory of pi. From here navigate to \/Retropie\/roms\/(Retro console name)<\/p>\n USB transfer is done by putting your ROMs onto a USB drive, plugging the USB drive into the RBZ and then using the file browser in the setting menu to transfer them.<\/p>\n Navigate to the Retropie settings menu, then select raspberry pi setup. In the next menu select XXXX then select XXXX to enable file sharing via SFTP<\/span><\/p>\n https:\/\/github.com\/RetroPie\/RetroPie-Setup\/wiki\/scraper<\/p>\n Web scraping can be done by pressing [select] then selecting \u2018scrape now\u2019, here you can set your scrape settings.<\/p>\n We recommend you select \u2018user decides conflicts\u2019 otherwise you can end up with many mis-labled games. Selecting this means you have to oversee the scraping process, when it cant decide what the ROM is, you pick from a list of possibilities.<\/p>\n Please note: Connection to an external monitor is advised and a keyboard wired or otherwise is required to complete this setup.<\/p>\n To enable achivements you must first have an account with http:\/\/retroachievements.org\/<\/a> , which is free.<\/p>\n Next, make sure your RBZ is connected to the internet.<\/p>\n Now in the retropie settings menu select \u2018retroArch\u2019, select achivements, log-in, enter your credentials for retroachivements.org and thats it, achivements are now enabled.<\/p>\n https:\/\/github.com\/RetroPie\/RetroPie-Setup\/wiki\/Updating-RetroPie<\/p>\n DO NOT use sudo apt-get update, upgrade or anything similar.<\/p>\n DO NOT select update in the raspberry pi settings manager<\/p>\n Doing so will require you re-install the OS and use our recovery tool to restore the configs.<\/p>\n Only update Retropie &\u00a0 the libretro emulators<\/p>\n There are a few ways to optimize power saving; Please note: Connection to an external monitor is advised. A We have a free recovery tool, it is for resetting messed up or buggy configurations. It overwrites all configuration files leaving your ROMs intact. You can also use this tool to quikly setup a fresh install of RetroPie.<\/p>\n To recover to factory settings download our RBZ recovery tool.<\/p>\n Upload it to your RBZ drop to the prompt [ALT+F4], execute the tool, reboot. Your device will now have the default configs again.<\/p>\n You will have to setup WIFI and anything else you had configured, again.<\/p>\n SSH can be used to access the RBZs command line remotely with a remote device on a local network.<\/p>\n Connecting over SSH takes system resources and therefore reduces the performance of the RBZ whilst connected. We recommend disconnecting from the RBZ before using the device <\/span>heavily<\/span>.<\/span><\/p>\n First install an SSH terminal, for the purposes of this guide we will be using putty.<\/span> Next, find out the IP address of your RBZ. It is available in the settings menu under ip address. Alternatively you can use a command line app to find it.<\/span> \n It is possible to change many settings using SSH and the retropie setup GUI. This allows you to change settings whilst a game is running on the device giving you an instant view of the effects.<\/span> Once logged in type.<\/span> sudo .\/RetroPie-setup.sh\/retropie_setup.sh<\/span> Once the blue menu loads, select option C \u2018Configuration \\ tools\u2019<\/span> This will display a chomprehensive list of settings and options.<\/span><\/p>\n https:\/\/github.com\/RetroPie\/RetroPie-Setup\/wiki\/splashscreen<\/a><\/p>\n To add custom splash screen files (JPEG or MP4) upload them to \/home\/pi\/Retropie\/splashscreens\/yoursplashscreens\/<\/p>\n The Splash Screen Menu can be accessed from the RetroPie Menu in EmulationStation<\/p>\n Ensure \u2018Enable Custom Splashscreen On Boot<\/strong>\u2019 is selected. If your flashing retropie to an sd card and would like the factory configuration, use our factory recovery tool to get everything configured as quicly as possible.<\/p>\n Many different user configurations can be made. It is advised that you dont alter the default configuration. However here are a list of usefull modifications that can be made.<\/p>\n The controls can be re-mapped in two ways. Firstly they are mapped from GPIO press signals to keyboard presses which in turn is mapped to a in-game button.<\/p>\n An extensive guide on setting up the custom controls can be found here <\/b>https:\/\/github.com\/RetroPie\/RetroPie-Setup\/wiki\/RetroArch-Configuration<\/a>.<\/p>\n You can also modify button to keyboard mapping in \/boot\/retrogame.cfg. We recommend you do not edit the port numbers in this file just the keypress action.<\/p>\n disables the savestates and is optional. If you want to enable it add this line to retroarch.cfg:<\/p>\n The following are four different templates for \/etc\/networking\/conf. Pick the template you need based on the security mode of the access point you are connecting to.<\/p>\nIndex<\/h1>\n
\n
\nConfiguration<\/p>\nBasics<\/h4>\n
\nWIFI connection setup
\nUploading ROMs
\nEnabling SFTP (wifi file transfer)
\nWeb scraping
\nEnabling achivements
\nPower saving
\nFactory settings recovery<\/p>\nIntermediate<\/h4>\n
\nCustom Splashscreen
\nEnable play from remote NAS
\nFlashing SD cards<\/p>\nAdvanced<\/h4>\n
\nControl configuration
\nAchievement configuration
\nCustom themes
\nGame development
\nManual WIFI setup<\/p>\nExternal resources<\/h4>\n
\nRetropie wiki
\nSudomod<\/p>\nFirst Boot<\/h1>\n
\nIn the Box<\/h4>\n
Configuration<\/h4>\n
\nIf you don’t need to pair any Bluetooth devices move on to the next step.<\/p>\nBasics<\/h1>\n
\nBluetooth connection setup<\/h4>\n
\nCurrently the software lacks support for Bluetooth audio. There are hardware workarounds (see the mods section).<\/p>\n
\ndiscover & connect-to available devices.<\/p>\nWIFI connection setup<\/h4>\n
Uploading ROMs<\/h4>\n
\nThe last section of that directory is the name of the retro console the ROM is for.Uploading ROMs has a three methods, SD tranfer, USB transfer & FTP transfer.<\/p>\nSD Transfer<\/h4>\n
\nAll you do is press the micro SD and it will eject. Then insert it into the device that has the ROMs you want to transfer. Emulationstation must be restarted before new ROMs become visible in the menu.<\/p>\nSFTP Transfer<\/h4>\n
USB Transfer<\/h4>\n
Enable SFTP access (NAS)<\/h4>\n
Web scraping<\/h4>\n
Enabling achivements<\/h4>\n
Updates<\/h4>\n
Power Saving<\/h4>\n
\nretropie setup script, run commands, core profile.
\ndisable WIFI & Bluetooth
\ndisable audio driver<\/p>\nFactory settings recovery<\/h4>\n
\nkeyboard, wired or otherwise, is required to complete the recovery\/setup process.<\/p>\nIntermediate<\/h1>\n
\nSSH<\/h4>\n
Connecting to the Retroberry zero over SSH<\/h4>\n
\nsudo nmap -sP 192.168.0.0-24 | grep -B 2 $YOUR_RBZ_MAC_ADDRESS | grep -Eo ‘[0-9]{1,3}\\.[0-9]{1,3}\\.[0-9]{1,3}\\.[0-9]{1,3}’<\/span>
\nwill usually suffice under Debian. Or you can use an android app like fing to map your network.<\/span> Now open your SSH terminal, ensure connection type is set to SSH, enter the IP address and then click \u2018connect\u2019. <\/span> A warning may pop up, click \u2018connect\u2019 again. <\/span> You will then see a login prompt for the RBZ. The default login credentials are (pi) user & (retroberry) password. <\/span><\/p>\nUsing SSH<\/h4>\n
Opening the retropie_setup GUI<\/h4>\n
Custom Splash Screen<\/h4>\n
\nFrom here you can either create a list of splash screens or select just one.<\/p>\nFlashing SD cards with alternate operating systems<\/h4>\n
Advanced<\/h1>\n
\nCustom configuration<\/h4>\n
Control configuration<\/h4>\n
Achievement configuration<\/h4>\n
Hardcore Mode<\/h4>\n
cheevos_hardcore_mode_enable = true<\/span><\/code><\/p>\nMore\/<\/b><\/span><\/code>Less<\/b><\/span><\/code> <\/b><\/code>Achievement<\/b><\/span><\/code>
\nInfo<\/b><\/span><\/code><\/p>\nIf
\nyou want to see some more RetroAchievements related message right
\nafter launching a game (such as successfull login and the number of
\ncheevos you have unlocked) you can use the Achievements Verbose Mode:<\/code><\/p>\ncheevos_verbose_enable
\n= true
\n<\/code><\/p>\nGame development<\/h4>\n
SDKs
\n(source devlopment kits) are availible for many of the old school
\nplatforms allowing you to program & distribute your own roms.
\nHere is a list of those kits, many thanks to the people that spent
\nmany hours reverse-engineering them.<\/code><\/p>\nMounting
\na network share<\/b><\/code><\/h4>\nManual WIFI setup<\/h4>\n