Troubleshooting guide

Batocera Black Screen After Boot: Fix the Splash-to-Black Display

Category: Game Console Boot

You boot Batocera from USB with a controller, see the splash, and then the display goes black before you can diagnose it.

Check the display connection first

Power off, then reseat the video cable at both the PC and monitor. Try a different port on the GPU if available. Power on and watch the monitor: if it shows “no signal” rather than a black image, the PC is outputting to another port. If the monitor stays awake but black, the signal is present but not rendering.

Test a safe display mode

At the boot menu, edit the boot entry and add nomodeset to the kernel line, then boot. If the picture returns, the issue is the graphics driver mode, not the USB or controller. Remove the edit after testing.

Rule out the USB and controller

Boot the same USB on another display or PC. If it reaches the menu elsewhere, the stick is fine. Unplug the controller and boot again; a faulty controller can stall initialization and leave a black screen.

Verification test

After any change, boot to the menu and leave it idle for two minutes. Success means the menu stays visible and the controller responds. If the screen goes black again, the fix did not hold.

Rollback note

If a config change caused this, mount the USB on another computer and restore the previous batocera.conf from backup, or rename it so Batocera rebuilds defaults. This is a known batocera black screen after boot pattern when display settings are forced.

Still stuck?

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

Ask for help with your GPU model and cable type.


Back to the service page · Ask about this exact symptom