RemoteDesk/packaging/windows/README-PREVIEW.md

RemoteDesk M0 Windows Portable Preview

This archive is a portable technical preview, not an installer or a finished remote desktop client. Extract the whole directory before starting it; no administrator privileges or system-wide installation are required.

Start

Run bin/remotedesk.exe. The Rust-native winit/wgpu/egui application is the only supported management UI. The package does not launch or support a browser UI.

The server does not listen on LAN interfaces. Its JSON API probes TCP and the pre-NLA RDP negotiation, then can start mstsc.exe or a native IronRDP window. The probe does not submit credentials or prove that NLA authentication succeeds.

Included

• bin/remotedesk.exe, providing the native Rust management UI and the only supported UI entry point.
• bin/remotedesk-credential-store.exe, providing masked local credential entry and direct Windows Credential Manager access.
• bin/remotedesk-rdp-session.exe, providing the secret-free IronRDP negotiation probe.
• bin/remotedesk-rdp-viewer.exe, providing a single-monitor native IronRDP compatibility window with fixed/custom initial sizing, dynamic resize, fullscreen, bounded automatic reconnect, Windows clipboard redirection, RDPSND local audio, session exit controls, and focus-bound keyboard/five-button mouse/wheel forwarding.
• bin/remotedesk-native-video.exe, providing GPU pipeline planning and a real hardware D3D11 device/context probe; rendering remains software.
• User and client-core documentation.
• manifest.json and per-file SHA256SUMS.txt.

Not Included

• MSI installation or Start menu registration.
• Runtime-enabled Linux graphical desktop, PipeWire/WebRTC media, CDN, or verified D3D11 zero-copy rendering.
• A runnable Linux Agent service.

The IronRDP window forwards keyboard, mouse buttons, movement, and wheel input while focused, and releases remote input state when focus is lost or the session closes. Use F11 or Alt+Enter to toggle fullscreen, Esc to leave fullscreen, and Ctrl+Shift+Q to close the session; triggering these commands releases remote input and does not forward the command key itself.

Passwords remain in Windows Credential Manager after entry through the local masked helper. The native viewer reads its referenced credential directly. Passwords are never written to UI state, argv, logs, or temporary .rdp files. Do not use this build as an unattended-access or security product.

Paired Linux Agent public keys are stored as integrity-sensitive, non-secret mappings at RemoteDesk/Linux/agent/<certificate-sha256>. The Linux Terminal panel can query or explicitly forget a mapping. With a configured Edge service and the Agent-local device_public_key plus certificate fingerprint, initial pairing and subsequent terminal/file sessions can all be established through Agent-outbound relay connections; direct pairing remains the fallback.