Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cyberdesk.io/llms.txt

Use this file to discover all available pages before exploring further.

The legacy Python Cyberdriver had two separate features for display reliability: persistent display installation and black-screen recovery. Cyberdriver 1.x uses RustDesk’s display stack instead.

What changed in Cyberdriver 1.x

  • RustDesk can create and manage virtual displays.
  • Windows service mode can access the login screen.
  • The client defaults new Windows sessions toward 1024×768 and adaptive scaling.
  • Cyberdriver diagnostics expose Windows virtual-display platform additions so support can see what the display layer is doing.

RDP disconnects

When RDP disconnects, Windows may remove or change the active display. RustDesk’s display service can enumerate displays and, when needed, create a headless virtual display. This is a better foundation than legacy screenshot-based black-screen detection.

If you see a black screen

  1. Open Desktop Tools and check display dimensions.
  2. Use diagnostics to inspect display_dimensions and platform_additions.
  3. Try reconnecting the remote session.
  4. If needed, use the dashboard’s Fix Black Screen tool for legacy machines.

Persistent display flag

The old --add-persistent-display flag is legacy-only. Do not use it for Cyberdriver 1.x unless support explicitly asks you to use an old Python agent.