# SuperRemote Windows alpha operator guide ## Start Extract the entire portable ZIP and run SuperRemote.exe. Keep `_internal` beside the executable. Python is bundled. The binary is unsigned; this is a local alpha, not a signed production installer. Alternatively run setup.ps1 then start.cmd from the source checkout. The optional install.ps1 inside the portable folder copies it to LocalAppData/Programs/SuperRemote and adds a Start Menu shortcut. It does not configure automatic startup, a service or firewall access. ## First connection between two PCs 1. Run SuperRemote on both Windows PCs. 2. On the host, select Share this PC. For a different computer on your LAN/VPN, enable Accept LAN/VPN connections before clicking Start sharing. This binds configured TCP 5421, fails on collision, and does not open Windows Firewall. 3. Send the host address, full fingerprint and generated token through a trusted channel. Fingerprints are public device identities; pairing tokens are secrets. The token works once, expires after 10 minutes, and is consumed even if the host denies the request. Generate a fresh token after a denied/failed pairing. 4. On the viewer, enter these details in Connect and click Connect securely. 5. The host approves or denies. View is the default. Enable control, clipboard and files only as needed. Enrollment is a separate host decision. 6. The viewer can select a display and quality mode. Check Control desktop to send input. Escape releases input focus; changing displays disables control until you enable it again. Held keys/buttons are released on disconnect. Control sessions also require an authenticated viewer ping within 8 seconds; the current viewer sends one every 3 seconds. Missing that deadline disconnects control and releases tracked input, even while frame ACKs continue. A dedicated watchdog checks every 100 ms, subject to normal Windows scheduling; this cannot recover an unresponsive operating system. View-only sessions do not require the control lease. Unsent consecutive pointer positions are coalesced while click/key transitions retain their order. 7. On the host, Stop sharing ends access. Ctrl+Shift+F12 works while this application's windows have focus; it is not a system-wide registered hotkey. If the other computer cannot reach TCP 5421, verify the address and LAN/VPN route and create a narrowly scoped application firewall rule through your approved Windows administration process. No public port forwarding is required for LAN use. Never resolve a busy project port by silently changing to another port. ## Enrolled access and recovery During approval, the host can enroll the viewer with exactly the selected permissions. An independent 256-bit return token is issued. The host stores its hash; the viewer stores the token protected by its Windows user's DPAPI. Enrolled connections still require host approval by default. The host may enable Allow enrolled devices without asking for the current application run, following the explicit confirmation. This is user-session access, not a Windows service; logging out or closing the app ends it. The viewer retries enrolled connections up to three times with backoff. Each attempt verifies the original host fingerprint and obtains a new permission grant. New attended viewers need a fresh pairing token. Automatic retry never enables unattended access on the host. Use Trusted devices / Refresh devices / Revoke to block a device and end its session. Grants expire after one hour; automatic retry can obtain a new grant if the host still authorizes the device. ## Clipboard, files and recordings - Clipboard is explicit text transfer in either direction, up to 32 KiB. There is no automatic clipboard synchronization. It requires clipboard permission. - Files transfer in either direction, one outgoing and one incoming at a time. The receiver validates names, sizes and SHA-256, writes a temporary file, and commits only a verified complete file into LocalAppData/SuperRemote/Inbox. Files get random prefixes to avoid overwrite and are never executed by the application. Limit: 100 MiB each; stalled or very slow transfers time out. - Save screenshot and Record session save the viewer's visible screen locally. Recording is opt-in each time, capped at 10 captured frames/second, 30 minutes or 1 GiB. Playback preserves actual timestamps in the .srrec container. Open it from Connect / Open session recording. No audio or MP4 export is provided. A viewer can always independently record what it can see; host consent says so. - Received files, screenshots and recordings are ordinary local files. Secrets use DPAPI, but these content files do not have application encryption at rest. ## Optional relay 1. Run SuperRemote on a Windows machine reachable from both endpoints. In Relay, choose the interface scope and Start local relay console (TCP 5422). 2. Configure routing/firewall for that relay through your approved process. The app does not purchase hosting, configure DNS, or open public firewall rules. 3. Copy the relay's address, fingerprint and access key to both endpoints over a trusted channel. Use the same random private room ID (16–80 characters). 4. On the host, enter these settings and Register this host with relay. 5. On the viewer, enter the same relay settings. In Connect, select Connect through relay and enter the target host's fingerprint and host pairing token. 6. Host approval works as for direct access. The relay fingerprint and host fingerprint identify separate machines; verify both. Admission uses pinned TLS 1.3 and the relay access key. A clean TLS shutdown then switches the admitted sockets to an opaque tunnel; the host and viewer perform an independent pinned TLS 1.3 handshake through that tunnel. The relay does not receive the host access token in admission and has no host private key. It sees addresses, timing and traffic sizes and can deny service. Limits: 8 waiting rooms, 16 admitted connections, global/per-source attempt limits and deadlines. This is a manually configured TCP relay, not a global broker or UDP NAT traversal. ## Data, settings and removal Local state is under `%LOCALAPPDATA%\SuperRemote`: identity certificate, encrypted key, DPAPI password, token hashes, DPAPI-protected viewer tokens, settings.json, Inbox and metadata-only audit logs. Audit rotates at about 2 MiB and keeps one previous log. Relay identity/key are in the Relay subdirectory. Device labels are user-supplied names, not verified human identity. Changing host_port or relay_port requires updating the target machine's project port registry first and restarting sharing. The viewer's port field specifies the destination machine; it does not change the local listener port. A busy port causes a visible error. One GUI instance per Windows user is enforced. To remove: stop sharing/relay, close all windows, remove the portable/install folder and Start Menu shortcut. Delete the private data directory only if you intend to discard identities, enrollment, received files and local audit history. No background task, OS service or firewall rule is installed by this alpha. ## Limits to keep visible Windows interactive desktop only. No UAC/secure-desktop control, Ctrl+Alt+Delete, pre-login service, remote reboot/reconnect across logout, audio, mobile/macOS/Linux clients, VNC/RFB interoperability, fleet accounts/MFA, signed updates, GPU video codec or automatic internet discovery. Monitor selection is implemented; mixed DPI/multiple physical-monitor behavior still needs a two-PC hardware test. Independent security review, WAN/relay deployment, long-session soak, and competitor performance comparisons are release gates, not completed results.