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.

When you disconnect from an RDP session, Windows typically terminates the display, causing Cyberdriver to lose its ability to take screenshots and control the desktop. The Persistent Virtual Display feature solves this by installing a virtual display driver that remains active even when RDP is disconnected.

​
What it does

The --add-persistent-display flag automatically installs and configures the Amyuni USB Mobile Monitor virtual display driver, which:
  • Creates a virtual monitor that Windows treats as a real display
  • Persists across RDP disconnections, system reboots, and Cyberdriver restarts
  • Allows Cyberdriver to continue taking screenshots and controlling the desktop even when you’re not connected via RDP
  • Combines perfectly with Black Screen Recovery for ultimate RDP resilience

​
How it works

  1. Automatic installation: Cyberdriver bundles the Amyuni driver files (adds only ~0.5 MB to the executable)
  2. Smart detection: Checks if the driver is already installed to avoid redundant installations
  3. One-time setup: Once installed, the virtual display persists permanently
  4. Automatic enablement: Ensures the virtual display is enabled on every run

​
Enable persistent display

cyberdriver join --secret YOUR_API_KEY --add-persistent-display
Options:
  • --add-persistent-display: Installs and enables the virtual display driver (Windows only)
Combined with other features (recommended): 
# Ultimate RDP-resistant setup
cyberdriver join --secret YOUR_API_KEY \
  --add-persistent-display \
  --black-screen-recovery \
  --keepalive
Administrator Privileges RequiredInstalling a display driver requires administrator privileges on Windows.Automatic ElevationWhen you run Cyberdriver with --add-persistent-display, it will automatically check for administrator privileges:
cyberdriver join --secret YOUR_API_KEY --add-persistent-display
  • If not running as admin: A UAC prompt will appear immediately, and Cyberdriver will restart itself with administrator privileges
  • If already admin: Cyberdriver will confirm, install the driver (if needed), and start normally
  • If already installed: Cyberdriver will simply verify the display is enabled and continue
Alternative: Start from Administrator PowerShellFor automated/unattended environments, you can skip the UAC prompt by starting from an Administrator PowerShell:
  1. Right-click PowerShell and select “Run as Administrator”
  2. Then run cyberdriver join --secret YOUR_API_KEY --add-persistent-display
  3. No UAC prompts will appear during installation

​
Configuring the virtual display

After the driver is installed, you can configure it like any physical monitor:
  1. Open Windows Display Settings (right-click desktop → Display settings)
  2. You’ll see a new monitor: “USB Mobile Monitor Virtual Display”
  3. Configure as needed:
    • Recommended resolution: 1024×768 (optimal for automation)
    • Display mode: Extend or make it the primary display
    • Position: Arrange relative to other displays
Pro tip: Set the virtual display as your primary monitor and configure it to 1024×768. This ensures Cyberdriver always has a consistent display to work with, regardless of RDP connection state.

​
How it works with RDP

Before (without persistent display): 
1. Connect via RDP → Display available ✓
2. Disconnect RDP → Display terminated ✗
3. Cyberdriver can't take screenshots ✗
4. Automation stops working ✗
After (with persistent display): 
1. Install virtual display (one-time setup)
2. Connect via RDP → Both displays available ✓
3. Disconnect RDP → Virtual display remains active ✓
4. Cyberdriver continues working normally ✓
5. Automation keeps running ✓

​
The ultimate RDP-resistant setup

Combine all three features for maximum reliability: 
cyberdriver join --secret YOUR_API_KEY \
  --add-persistent-display \
  --black-screen-recovery \
  --keepalive
What you get:
  • ✅ Persistent Display: Virtual monitor survives RDP disconnection
  • ✅ Black Screen Recovery: Automatically fixes black screen issues
  • ✅ Keepalive: Prevents idle timeouts and session locks
  • ✅ Result: Cyberdriver stays alive and responsive 24/7, even through RDP disconnects

​
When to use this

Persistent Virtual Display is essential for:
  • RDP-based workflows where you need automation to continue after disconnecting
  • Unattended automation running on remote Windows machines
  • Long-running workflows that shouldn’t be interrupted by display issues
  • Production environments where reliability is critical

​
Removal (optional)

The virtual display persists even after Cyberdriver exits (by design). If you want to remove it: Option 1: Disable (keeps driver installed)
  1. Open Windows Display Settings
  2. Detect displays and disable the “USB Mobile Monitor Virtual Display”
Option 2: Uninstall completely
  1. Open Device Manager (Win + X → Device Manager)
  2. Expand “Monitors”
  3. Right-click “USB Mobile Monitor Virtual Display”
  4. Select “Uninstall device”
  5. Check “Delete the driver software for this device”
  6. Restart Windows
The virtual display is designed to persist across reboots. You typically want to keep it installed once set up, as it enables 24/7 automation without manual intervention.