This is the user documentation for Recalbox. We hope you will find the answers to your questions.
To get started, here is a presentation of the system and some suggestions.
RecalboxOS is the operating system of the Recalbox project, a ready-to-use emulation console based on the Raspberry Pi.
For more information, please refer to the website http://www.recalbox.com
RecalboxOS can be described with one word : EASY.
We want to provide a system that is as user-friendly and intuitive as possible.
No need to modify a large number of configuration files or to connect in SSH.
Just install the system and enjoy.
The OS configuration is made by a single file, named
The latter allows a precise configuration of all emulators !
Compiled with buildroot, which means that the root file system is only 150MB compressed.
The backup system is based on NOOBS : possibility to reinstall the system directly from the SD card or obtaining the latest version on the Internet.
Access via the network to roms directories, screenshots and game backups.
Configuration of your game controller straight from the interface : once the configuration is completed, it will be compatible with all emulators.
Background music on the interface.
Integrated support for PS3, Xbox360, 8BitDo and Bluetooth controllers (pair a controller, and play !).
Support in French, English, Spanish, German, Italian, Portuguese and maybe more to come if you participate.
Interface based on EmulationStation2 developed by Aloshi.
Optimized FBA version with 4-player compatibility.
Having GPIO drivers to use arcade controls or your original Nes, Snes, Megadrive, PSX controllers.
Support for 2-player Xin-Mo controllers.
Miroof's Virtual Gamepad support, use your phone as a controller.
Netplay retrogaming (online games)
We suggest you to look the page about Installing Recalbox, you might also want to check out the Manual to understand the basics on how the operating system works, if some words are too technical, the Glossary might be of help too.
We have some lists about compatibility, the Board compatibility page describes the various versions of recalbox you can download, along with supported emulators, if you have an actual computer, we recommand seeking the PC Compatibility documentation.
Also, the Peripheral Compatibility page lists some tested peripherals, which might be useful, keep in mind those lists may not be exhausive.
Recalbox is a free project, as such, people work on it on their free time, which means it may have some bugs or may not be as "plug and play" as a full fledge commercial product, so the best advice we can tell is to be curious, read the documentation, and back up things before doing anything you might not be sure about.