Troubleshooting guide
Moonlight Black Screen After Sleep: Restore the Host Frame
Category: Game Streaming
You wake the host, reconnect Moonlight, and the stream opens to a black frame instead of your desktop.
Check the host display state first
On the Sunshine host, move the mouse and press a key, then watch the physical monitor. If it stays dark, the display did not wake from sleep, so the host has no frame to encode. Wake it manually and confirm the desktop is visible before reconnecting. If the monitor shows the desktop but Moonlight stays black, the display is awake and the problem sits in the capture or encoder path.
Confirm Sunshine is still encoding
Open the Sunshine status page on the host and check that the stream is active and the encoder is running. If the session shows as active but no frames are produced, stop the stream from the status page, wait a few seconds, and start it again. This clears a stale capture session left over from sleep.
Test with a fresh connection
Disconnect Moonlight completely, then reconnect. A successful result is a live desktop image within a few seconds. If the frame appears only after you interact with the host, the display wake is the cause; if it never appears, restart the Sunshine service and repeat the test. This is the controlled check that separates a display wake issue from an encoder issue when you see a moonlight black screen after sleep.
Rollback and recovery
If a recent Sunshine or GPU driver update came before the problem, roll it back and retest. Keep a note of the working version so you can return to it. If the black frame persists after these steps,

Ask for help with your host OS, GPU, and Sunshine version.