[feat] Session timeout on disconnect / disable pause state

[KaiStarkk]

Select Topic Area

Feature Request

Body

Problem

When a Moonlight client disconnects (network drop, app crash, minimize, etc.), Sunshine keeps the session in a "paused" state indefinitely. The undo commands from global_prep_cmd
only execute when the session is explicitly quit, not on disconnect.

This creates problems for users who use prep commands to modify system state:

• Virtual display configurations left enabled
• Audio sinks not reverted
• Input devices left in modified state
• Security-sensitive configurations (screen locks disabled, input devices disabled for remote-only access) left in unsafe state

If the client crashes or the user forgets to explicitly "Quit Session", the system remains in the prep'd state until manual intervention.

Use Case

I use Sunshine to stream to a headless virtual display while disabling physical monitors and local input devices (security measure - only the stream can interact with the unlocked
session). If Moonlight crashes or disconnects unexpectedly, local input remains disabled and I'm locked out until I can SSH in or force quit the session from another device.

Proposed Solution

One or both of:

Option A: Session timeout
session_disconnect_timeout = 30
Auto-terminate session N seconds after last client disconnects. Value of 0 preserves current behavior (infinite pause).

Option B: Disable pause entirely
terminate_on_disconnect = true
Treat disconnect as session end. No pause state - client disconnect immediately triggers session termination and undo commands.

Workarounds Considered

• Log file monitoring for "CLIENT DISCONNECTED" events
• Polling network connections on streaming ports
• External watchdog service

These work but add complexity. Native support would be cleaner and more reliable.

Related

• #3481 - DO/UNDO on connect/disconnect (related but different - that requests commands on connect/disconnect events while keeping pause state; this requests eliminating pause state)
• Automations with Sunshine: Is there a service that runs when a streaming session is initiated and terminates when it ends? #209 - Session lifecycle automation

[KaiStarkk]

FWIW the workaround that I've found easiest is an external watchdog service. It watches for disconnection and sends the quit instruction to sunshine via API.

[oliverm91]

Mind to share your solution code?