Troubleshooting guide

Batocera Splash Then Black Screen: Isolate the Display Output Before Reinstalling

Category: Game Console Boot

You boot Batocera from USB with your controller connected, the splash appears, and then the display goes black. This guide isolates the display output issue before you reinstall or change hardware.

Check the display cable and port

First, confirm the monitor is receiving a signal. Unplug and reseat the HDMI or DisplayPort cable at both ends. If your PC has a dedicated GPU, move the cable from the motherboard port to the GPU port (or vice versa). Power on and watch for the splash. If the splash returns but the screen still goes black, the issue is likely resolution or driver related, not a dead cable.

Test with a different display or safe mode

Connect the PC to a different monitor or TV using the same cable. If the splash and menu appear, your original display may not support the default resolution. Next, boot Batocera and press a key during the splash to enter the boot menu, then select safe mode or verbose mode if available. A verbose boot that stops at a specific line (for example, a GPU driver message) tells you the black screen is a driver handshake failure, not a corrupted USB.

Verify with a controlled reboot

After any change, perform a full power cycle: shut down, unplug power for 30 seconds, reconnect, and boot again. If you reach the Batocera menu and can navigate with your controller, the batocera black screen after boot is resolved. If the screen remains black, note whether the controller LED stays on; a lit controller suggests the system is running but the display output is lost.

Rollback and recovery

If a recent configuration change caused the black screen, boot from the USB and rename the batocera.conf file to batocera.conf.bak to restore defaults. Keep a backup of your USB image before further changes. For persistent display issues,

A mini PC, controller, and monitor running a Batocera game

Ask for help with your GPU model and boot logs.


Back to the service page · Ask about this exact symptom