Repository navigation
ApolloVibe 2026.6.1-ms6
This release makes Apollo wait for the input desktop before it starts capturing, so a session that is still signing in or is locked no longer ends in a failed start. Everything from ms5 is included.
The input desktop wait
When a session starts while Windows is on the Winlogon (secure) desktop, for example at the lock screen or just after a login, Apollo used to start capture right away, fail to open the desktop, and give up. Now it waits for the input desktop to become available first. It listens for desktop-switch events and also polls every 250 ms as a backstop.
Two new options control it. Both are in the Advanced tab of the web UI and documented in docs/configuration.md:
input_desktop_wait_timeout: seconds the capture thread waits before it starts capturing. Default 180. Range 0 to 3600. 0 turns every wait off.input_desktop_wait_request_timeout: seconds an HTTP launch or resume request waits for the desktop before Apollo answers 503. Default 3. Range 0 to 60. It is never longer thaninput_desktop_wait_timeout. 0 turns the wait off for requests.
The request wait is short on purpose. Apollo's HTTPS server handles one request at a time, so a long wait inside a request would stall the client's status polls, which time out after 5 seconds in Moonlight.
New log lines you can look for: Input desktop wait: ..., Input desktop became accessible after N ms (...), Input desktop still not accessible after N ms, and Input desktop wait cancelled after N ms. If the desktop-switch listener cannot be installed, Apollo logs desktop switch hook unavailable, polling only and polls instead.
Behaviour change: a launch or resume request now waits up to 3 seconds (input_desktop_wait_request_timeout) for the input desktop. If it is still unavailable, Apollo answers 503 with the message "The Windows desktop is not ready yet (the session is still signing in or is locked). Please try again in a few seconds." Before, the same situation returned the generic "Failed to initialize video capture/encoding" 503 immediately. moonlight-qt does not retry a refused launch by itself, so retry from the client. We did not check other clients.
The two encoder probes Apollo runs when it starts do not wait, so a locked desktop at boot cannot hold up the web UI. The probe that a launch or resume request runs waits only as long as the request limit above.
How this was checked
Built from the merged master (PR #10, 681e36a8) with the repo's own packaging script. The unit tests pass: 257 run, 253 passed, 4 skipped (the Windows-only mouse tests), 0 failed, with the audio, encoder, download-file and external-command tests excluded. That includes the new wait and wait-policy suites, a suite that runs against the real desktop and the real listener thread, and the config and locale consistency suites. The new option names and log phrases are present in the built sunshine.exe and absent from ms5's.
On the reference host, MultiSeat started this build's Apollo in fresh seat sessions and again after a session reconnect, and each start was normal.
Not verified
- The wait itself has not run against a lock screen or a login that holds the Winlogon desktop for a long time. It is covered by unit tests with a fake clock, not by a live lock screen.
- The 503 retry path has not been exercised by a real Moonlight client.
- Whether the desktop-switch listener delivers events inside Apollo on a real host is unconfirmed in Apollo itself. (MultiSeat's own copy of the same listener did fire inside a seat session on the reference host.) If it cannot be installed, Apollo falls back to polling.
- Not run against a real client, display or encoder beyond the normal start described above.
Install
apollovibe-windows-x64.zip is the complete portable build: sunshine.exe, assets/ and tools/. MultiSeat's installer pulls it from releases/latest/download/ and needs no change.
SHA-256 of apollovibe-windows-x64.zip:
B39BDC299988A712FBF5DAD68C0847E05E65BAF733B55194297C6B2C9374AD5C
SHA-256 of sunshine.exe:
7E9FA1572579879FA98716C74753DA7EC070F0C8209FE5177F2D73CD0C1B33CC