61edbf59bf
Viewer: - Toolbar: Ctrl+Alt+Del, clipboard paste, monitor picker, file transfer, chat, WoL buttons - Multi-monitor: agent sends monitor_list on connect, viewer can switch via dropdown - Clipboard sync: agent polls local clipboard → sends to viewer; viewer paste → agent sets remote clipboard - File transfer panel: drag-drop upload to agent, directory browser, download files from remote - Chat panel: bidirectional text chat forwarded through relay Agent: - Multi-monitor capture with set_monitor/set_quality message handlers - exec_key_combo for Ctrl+Alt+Del and arbitrary combos - Clipboard polling via pyperclip (both directions) - File upload/download/list_files with base64 chunked protocol - Attended mode (--attended): zenity/kdialog/PowerShell consent dialog before accepting stream - Auto-update: heartbeat checks version, downloads new binary and exec-replaces self (Linux) - Reports MAC address on registration (for WoL) Relay: - Forwards monitor_list, clipboard_content, file_chunk, file_list, chat_message agent→viewer - Session recording: when RECORDING_DIR env set, saves JPEG frames as .remrec files - ALLOWED_ORIGINS CORS now set from NEXT_PUBLIC_APP_URL in docker-compose Database: - groups table (id, name, description, created_by) - machines: group_id, mac_address, notes, tags text[] - Migration 0003 applied Dashboard: - Machines page: search, tag filter, group filter, inline notes/tags/rename editing - MachineCard: inline tag management, group picker, notes textarea - Admin page: new Groups tab (create/list/delete groups) - API: PATCH /api/machines/[id] (name, notes, tags, groupId) - API: GET/POST/DELETE /api/groups - API: POST /api/machines/wol (broadcast magic packet) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
RemoteLink Agent
Cross-platform remote support agent. Streams the screen to the RemoteLink server and handles remote mouse/keyboard input and script execution.
Quick start
Run-once (portable, no install)
# Linux / macOS
python agent.py --server https://remotelink.example.com --enroll YOUR_TOKEN --run-once
# Windows — run the pre-built exe
remotelink-agent.exe --server https://remotelink.example.com --enroll YOUR_TOKEN --run-once
Permanent install (saves config, reconnects on reboot)
python agent.py --server https://remotelink.example.com --enroll YOUR_TOKEN
# Config saved to /etc/remotelink/agent.json (Linux) or C:\ProgramData\RemoteLink\agent.json (Windows)
# Start normally on next run:
python agent.py
Windows service (runs on login / system start)
remotelink-agent-service.exe install
remotelink-agent-service.exe start
Mass deployment (NSIS installer, silent)
RemoteLink-Setup.exe /S /SERVER=https://remotelink.example.com /ENROLL=YOUR_TOKEN
This silently installs, enrolls the machine, installs the Windows service, and starts it — no UI shown.
Building
# Install deps + build portable binary (all platforms)
./build.sh
# Output: dist/remotelink-agent (Linux/macOS)
# dist/remotelink-agent.exe + dist/remotelink-agent-service.exe (Windows)
# RemoteLink-Setup.exe (Windows + NSIS installed)
Enrollment tokens
Generate enrollment tokens in the RemoteLink web UI under Admin → Enrollment Tokens.
Each token can optionally have:
- An expiry date
- A max-uses limit
- A label for tracking
Protocol
The agent connects to the relay WebSocket server:
ws://<relay-host>:8765/ws/agent?machine_id=<id>&access_key=<key>
It streams JPEG frames as binary WebSocket messages and receives JSON control events.