• 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 Tri-mode PCB or  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 hardware 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 Setup:

Recalbox Official Setup Guide (download the Burnable .img)
Recalbox Video Setup Tutorial

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:

Download this .zip file.

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.

Recalbox Support: 

Recalbox Wiki

Recalbox Forums

Reddit /r/Recalbox


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. 

RetroPie Setup:

Trackball Note: Xarcade2Jstick may be causing the trackball not to work when using MAME4all, so use lr-MAME2003 until that's figured out. 


Step 1 - Download and Write Image to MicroSD: Follow the RetroPie Official Installation Guide, but stop at 'Configure Controllers'.

Step 2 - Setup Setup Xarcade2Jstick: RetroPie uses Xarcade2Jstick to make the X-Arcade register as two individual gamepads (instead of one big keyboard).


  • At first boot, RetroPie requires you to set up a controller, for that reason the workaround steps for getting the Xarcade2Stick working are more complicated than should be necessary (you would be able to skip steps 1 and 2 below).
    The RetroPie devs really need to make it possible to skip this entirely for keyboard-only use. 


  1. While at the RetroPie WELCOME screen, press F4 on your connected keyboard to get to the command line.
  2. Type sudo /home/pi/RetroPie-Setup/ (this is CaSe SeNsItIvE) and press Enter 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.
  3. Follow the video instructions (made by our friend ETAPRIME) below to finish setup, but we do recommend mapping to this layout:

Step 3 - Adding ROMs:

Method 1: Open File Explorer (on a PC connected to the same network) and look under Network for your RETROPIE. If it doesn't show up try putting \\retropie in the address bar. Put ROMs in the correct folders, arcade ROMs go in the 'arcade' folder.

Method 2: Enable SSH, then use an FTP client such as Filezilla to log into it. Host: retropie, Username: pi, Password: raspberry, Port: 22

Method 2: Put your ROMs onto an external USB thumb drive as shown here

NOTE: To force rescan of new games, press Start >Quit>Restart EmulationStation

Step 4 - Play!

For arcade games be sure to choose lr-MAME2003 as your emulator for full trackball support. 

Other notes: 

  • 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
  • You can use HDD Raw Copy Tool to clone your microSD to another microSD of the same or even bigger size. 

Layout Fix for N64 & Dreamcast: 

Note that if you reconfigure your controllers again you will need to replace the files below again.

N64: Download this .zip file

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/

RetroPie Support:
RetroPie Forums
Reddit r/rRetroPie


Stay up to date with PiMAME + X-Arcade Integration Here. - Thanks to Shea Silverman!

Here is his page on setting things up.


Setting up with MAME4ALL + PI - by Aaron Ardiri