IMPORTANT
Please do not update the Batocera software. Doing so will cause the system to not work.
If the console has been updated, it will need to be sent back for re-imaging here.
Console Setup
1. Unwrap the game controllers and add batteries, then plug the included USB-A dongles into any USB slots on the console.
2. Plug in the console, then press the power button.
3. Once the main interface is loaded, turn on one controller using the switch at the bottom, then press Start to connect it. A solid red light at the top of the controller will indicate that it is connected. Do the same for the second controller. Controllers go dormant quickly to save battery. Wake them up by pressing Start.
Basic Controls
Select: "A"
Back: "B"
Search: "X"
Exit Game: "Mode" + "Start" (P1 controller only)
Credit/Coin: "Select" (MAME / Arcade only)
Additional Controls
In-game save: "Mode" + "X"
In-game load: "Mode" + "Y"
Power off: "Start" > "Quit" > "Shutdown System".
Add game to favorites: Hold "Y" on a game
Unfavorite game: Hold "Y" on a favorited game
WiiMote
The easiest method of playing Wii is to use a generic USB or battery powered IR bar with a Wiimote. We do not recommend using a Dophinbar as it is difficult to setup, and accuracy tends to be lower.
If you have both components, turn on your IR bar, then launch a Wii game. Press "Sync" on your Wiimote. You should see a notification that it connected successfully on the top left of the screen.
You can view the full documentation for the Wiimote
here.
Sinden Light Gun
The Sinden Light gun is plug-and-play with this system. With the system running, plug each gun into any USB port on the PC, then follow the steps below to calibrate the aim. Once calibrated, you should not need to re-calibrate it. Make sure to use the gun at least 5 or so feet away for the best results.
1. Plug the Sinden into any USB port.
2. Hold down the left D-pad button until the crosshair stays centered.
3. Line up the sight and shoot the cursor in the center of the screen.
You can view the full documentation for light guns in Batocera
here.
Troubleshoot
No Audio
This is a very common and easy-to-fix issue. It's related to the Batocera software itself, where it does not automatically recognize the HDMI as the primary audio output.
Press "Start", then navigate to "System Settings", then "Audio Output". Select the HDMI option, then press "B" until you're back on the platform selection wheel. Audio should immediately play from the game video.
OLED Steam Deck SD Card Will Not Boot
After inserting the micro SD card and before you power on your Steam Deck, hold the "volume down" button. While still holding volume down, press the power button and wait until the boot menu appears. Select “EFI SD/MMC Card”.
For the OLED Steam Deck, after selecting EFI SD/MMC, immediately press DOWN on the directional pad to select "continue boot", then DOWN again to select "verbose".
You will need to do this boot process each time you power on the Steam Deck in order to load Batocera. To revert back to the standard Steam OS boot, remove the SD card and power on normally. You can store your SD card in the SD slot in between uses.
Game Will Not Boot
If a game does not boot, hover over the game in the game list, then hold down the A button on your controller. There you will see an option called "Advanced Game Options", with an option called "Emulator". Change the emulator from "Auto" to another emulator in the list, then attempt to boot the game again. If that doesn't work, try the next emulator on the list.
Wireless Controller Will Not Respond
The included PS2 controllers go dormant quickly to save power. To wake it back up, press "Start" on the controller, and wait a few seconds. The solid red light should come back on, then the controller should work normally.
If one of the provided PS2 controllers doesn't respond, and it simply blinks with red/green lights, turn off both controllers, and unplug them both. Plug both back in, then turn on one and press "Start". When that controller shows a solid red light, turn on the second controller and press start.
Controller Mapped Incorrectly: Unable to Remap
Connect a keyboard and mouse to the system and press F1 to access the file manager. Navigate to Share > System > Configs > Emulationstation, then delete the file called "es_input.cfg". At the top left of the screen, select File > Quit with your mouse to exit back to the game wheel, then press Start on your controller and select Quite > Restart. The system should now prompt you to remap your controller.
If these steps cannot be followed for some reason, you will need to send back your hard drive to be re-imaged back to the original settings. We provide that service
here.
System Frozen
If the standard method of Mode + Start isn't working to exit a game after 10-20 seconds, press and hold the power button on the front of the console to turn it off and back on. This won't damage the system.
Arcade/MAME Game Will Not Boot
You may need to change the emulator. To change the emulator for an individual game, hover over the game title, and hold down the A button, select Advanced Options, then change the emulator to Libretro MAME or MAME as needed.
Arcade/MAME: Vertical Game Aspect Ratio
Hover over the game and hold the A button, then select Advanced Game Options > Game Aspect Ration, then select Core Provided. If this doesn't immediately fix the issue, follow the below steps:
1. On the Platform wheel, press Start and go to Game Settings
2. Make sure Video Mode is set to Auto, and that Game Aspect Ratio is set to Auto
3. Select Game Rendering & Shaders
4. Make sure Integer Scaling is set to Auto
5. Back out and select the MAME wheel, then press Select
6. In Advanced System Options, make sure Video Mode is set to Auto, and Game Aspect Ratio is set to Auto.
7. Select “Game Rendering” and turn Integer Scaling to Auto.
8. Back out and select Quit to reset the system, then select any vertical aspect game to confirm the resolution scale.
FAQ
Why do PS3, Wii U and Switch games sometimes stutter during gameplay?
Emulators for newer systems load new textures and environments on the fly, in a process known as "shader caching". This is how these emulators work, and there is no configuration that will completely eliminate it. It's also not a hardware limitation, and the same stutter will occur even on cutting edge hardware.
Why do PS3 games take so long to load?
The first time a PS3 game loads takes far longer than every time after. This is normal, and there is unfortunately no way to speed the process up.
If you are adding games to the Steam Deck image, you will additionally need a
dock with USB ports, as well as a keyboard and mouse to follow the USB guide above.
Add Additional Controllers
Please see the full documentation on compatible controller types here.
Boot to Windows (for models with a Windows 11 hard drive)
Turn off the console and connect a keyboard. As soon as you turn the console back on, continually press "Delete" to enter the BIOS menu. Arrow to the right to select the "Boot" tab, then change "Boot Option #1" to the Windows drive by pressing "Enter."
If the Windows drive is not visible, select "UEFI NVMe Drive BBS Priorities" under the same "Boot" tab, and select Windows from there.
Change Controls for Individual Games / Systems
Launch any game and press "Mode + A" to open the "Quick Menu" in the Retroarch emulator. Select "Controls," with the "A" button. Select the controller port you would like to make changes to with "A" (Player 1 is Port 1, etc.). Once your changes have been made, select "Manage Remap Files" to save the changes based on the below goals:
1. Save Game Remap File: saves the control remapping to only this game (recommended)
2. Save Core Remap File: saves the control remapping for all games for that system (i.e. all Dreamcast games).
Change Rendering Resolution
Some consoles will allow you to increase the rendering resolution without affecting performance. When the resolution is increased, jagged edges in older 3D games are smoothed out, which can help older games will look more modern.
This isn't available for most systems. If you change it and performance is effected, you can change it back to the original settings.
To access upscaling options (when available), select a system on the main platform wheel. Press Select, then Advanced System Options. You're looking for the term "Rendering Resolution". If available, select a multiple of the original resolution. Press B to back out to the game wheel, then press "A" start the game.
Change User Interface Theme
The theme refers to the overall look of the scroll wheels where platforms and games are displayed. You can change a theme by pressing "Start" on your controller, then "UI Settings" > "Theme Set"
Add Additional External Hard Drive
Follow this
video guide to add an additional hard drive with roms to the existing build.