Troubleshooting guide
Moonlight Black Screen After Sleep: Fix the Host Frame Before Reconnecting
Category: Game Streaming
You wake the host, reconnect from Moonlight, and the stream opens to a black frame instead of the desktop. This is a host-side frame delivery problem, not a client rendering issue, so diagnose the host before reconnecting again.
Check the host display state
On the Sunshine host, confirm the monitor is actually awake and showing the desktop. If the display is off or the session is locked, Sunshine may capture a black frame. Press a key or move the mouse on the host, then confirm the desktop appears. If the screen stays off, fix the host display wake first; reconnecting Moonlight will not help.
Check the encoder after wake
Open the Sunshine web UI and look at the current session status. If the encoder shows idle or failed after sleep, stop the stream and restart the Sunshine service. Then start a new stream. If the encoder recovers and shows an active session, the black frame was caused by a stale encoder state after wake.
Verification test
Disconnect Moonlight fully, wait ten seconds, and reconnect once. If the desktop appears, the fix worked. If the frame is still black, repeat the host display check and service restart in that order before trying again.
Rollback and recovery
If restarting the service makes things worse, stop Sunshine, reboot the host, and start Sunshine manually. Reconnect only after the host desktop is visible. This returns you to a known working state without changing encoder settings.
If the moonlight black screen after sleep persists after these checks, the host frame path needs a closer look.

Ask for help with your Sunshine version and session status so the next step is targeted.