- The X-Arcade acts like a keyboard when using the default USB cable that comes with it (just like on a PC), the Xarcade2Jstick user-space daemon (made by Florian Müller) will make it act like 2 gamepads instead. The trackball acts like a mouse. Use the layout below when setting up your controllers.
- You can instead use our Xbox 360 adapter to make it act like 2 Xbox 360 gamepads which gives you more functions such as switching between analog and D-Pad controls and is probably easier overall since you don't have to use the Xarcade2Jstick, but there is the extra cost of the adapters involved.
- Start by making sure your controller is working on a PC with our test program. If it doesn't work on PC it's not going to work on a Pi either.
- These require .78 MAME ROMs.
RetroPie vs. Recalbox - Lifehacker DIY Retro Game System Showdown - The general consensus we've seen is that Recalbox is easier to set up and has all the features that most people want and just works, while RetroPie has more customization but is more for advanced tinkerers. Users have likened Recalbox to iPhone and RetroPie to Android. For this reason, we recommend using Recalbox for most users. We do not offer direct support for either of these, however.
We offer no support for any of this, but we did our best to make it as easy as possible for you to get up and running as painlessly as possible. Links to get support are provided below.
Recalbox allows you to re-play a variety of video game consoles and platforms in your living room, with ease! RecalboxOS is free, open source and designed to let you create your very own Recalbox in no time!
Recalbox Official Setup Guide (get the Burnable Image)
Recalbox Video Setup Tutorial (Note: This video uses an older version where you manually copied the files to the SD card, you will now instead be writing the image as shown in the Official Setup Guide above)
Recalbox Hotkey = Left Pinball Button
Exit Emulator = Select(Left Pinball button)+Start
Per-Emulator Custom Controller Mapping (doesn't work with MAME or N64).
Logging into your Recalbox to add files and ROMs (on a PC connected to the same network):
Method 1: Open File Explorer and look under Network for your Recalbox. Add ROMs to the correct system folders found in \share\roms\ (MAME roms go in the mame directory)
Method 2: Open a web browser to http://recalbox/
To force rescan of new games, press Start >Game Settings>Update Games Lists
Layout Fix for N64:
For N64: Rename the file \\RECALBOX\share\system\configs\mupen64\mupen64plus.cfg to save it as a backup, then put our mupen64plus.cfg file in this folder.
RetroPie allows you to turn your Raspberry Pi into a retro-gaming machine to enable you to play your favorite Arcade, home-console, and classic PC games with the minimal setup. Start with the beginner's guide (with video guide) to the right.
The Easy Way:
- Download HDD Raw Copy Tool and install it on your PC.
- Download our custom X-RetroPie image.
- Write the image to your MicroSD card (must be 8GB or bigger).
The Manual Way:
- IMPORTANT NOTE: Do not 'Update all installed packages' under 'RETROPIE SETUP' as it will break trackball/mouse support! We are not aware of any fix if that happens other than to reformat/reinstall from scratch. You can 'Update RetroPie-Setup script' and the Update found under 'RASPI-CONFIG' however.
- Follow one of the guides below, and once booted to the 'WELCOME' screen for the first time you will need to jump down to the Xarcade2Stick Setup Guide below.
Xarcade2Jstick Setup Guide:
RetroPie uses Xarcade2Jstick to make the X-Arcade register as two individual gamepads (instead of one big keyboard).
- There's an 'Xarcade2Jstick' driver already in the Retropie setup -> packages, but users report it does not work with Pi3 (so use this guide instead).
- Xarcade2Jstick looks for an X-Arcade device when it is started. That means you need to connect your X-Arcade before Xarcade2Jstick is started. When using Xarcade2Jstick as a service, you could shut down the RPi, connect the X-Arcade and start your Rpi again.
- Type all blue commands below without the quotes and press Enter after each step. These are CaSe SeNsItIvE. You can optionally do these commands from SSH if you know how and prefer to copy and paste the commands instead of typing them all out.
- While at the RetroPie main menu press F4 on your connected keyboard to get to the command line.
- Type sudo /home/pi/RetroPie-Setup/retropie_setup.sh to open RetropPie Setup. Choose 'Configuration/Tools', then 'wifi - Configure Wifi' and connect to your Wifi network. It will show your IP address if connected properly, so once you verify that you're connected Exit the Setup to get back to the command line. From here you can now optionally enable SSH to do the rest of the commands below from your PC so you can copy and paste the commands instead of typing them all out.
- Type git clone https://github.com/petrockblog/Xarcade2Jstick and press Enter.
- Type cd Xarcade2Jstick press Enter.
- Type make and press Enter.
Type wget http://www.xgameroom.com/service/ServiceFiles/main.c and press Enter.This is our custom version with exit game fix.
Type cp main.c src and can we get another Enter.
- Type sudo make install and then Enter.
- Type sudo make installservice and then Enter.
- If you haven't already, connect your X-Arcade controller to the USB port of your RPi and type sudo reboot and press Enter one last time. This takes you back to RetroPie.
- At the WELCOME screen if you did the steps above correctly then it should show '2 GAMEPADS DETECTED'. Hold any button on the X-Arcade to begin mapping the controller, we recommend mapping to this layout. You can press and hold any button to skip setting any unused analog inputs (when you get to LEFT THUMB).
- Play! The first time you run an Arcade game be sure to choose 'lr-MAME2003' as your permanent emulator for full trackball support.
Hotkey = Left Pinball Button
Exit Emulator = Select(Left Pinball button)+Start 1
- Retroarch Menu = Select + X (Retroarch-emulated games only)
- Mega Drive: Enable 6-button mapping = Open Retroarch Menu>Quick Menu>Options and set the two Input devices to '6 button pad'.
- Controller Remapping Per-Emulator
Method 1: Open File Explorer (on a PC connected to the same network) and look under Network for your RETROPIE. Put ROMs in the correct folders, arcade ROMs go in the 'arcade' folder.
Method 2: Put your ROMs onto an external USB thumb drive as shown here.
To force rescan of new games, press Start >Quit>Restart EmulationStation
You can access other system files by logging into your Retropie with Filezilla; Host: Retropi, Password: raspberry, port: 22
Layout Fix for N64 & Dreamcast:
Note that if you reconfigure your controllers again you will need to replace the files below again.
Place the InputAutoCfg.ini and mupen64plus.cfg file in /opt/retropie/configs/n64/ with the ones in the .zip file.
Dreamcast: Download this .zip file
Replace the file /opt/retropie/configs/emu.cfg with the one in the .zip file.
Put the 2 'controller_Xarcade-to-GamepadDevice*.cfg' files in /opt/retropie/configs/dreamcast/mappings/