Developer tools#Device control
Airhand: self-hosted QUIC remote desktop with hardware encoding at up to 120 fps
Open-source remote desktop: GPU encoding, QUIC transport, up to 120 fps, a one-command Docker Compose relay, end-to-end encrypted sessions.
Project facts
GitHub Ecosystem- License
- MIT
- Language
- Rust
- Stars
- 1,240
- Data checked
- 2026-11-14
Snapshot figures reflect the check date and may change over time.
Most commercial remote-desktop products ask you to accept their cloud relay and their subscription. Airhand takes the self-hosted road: the same program acts as both the host (the controlled machine) and the controller, and the relay server is one you deploy yourself — the README says a single Docker Compose command brings it up. GitHub’s API reported 1,240 stars on November 14, 2026.
Core features
- Hardware encode and decode: the host encodes on the GPU in low-latency mode without B-frames (NVENC, Quick Sync, AMF, VideoToolbox, MediaCodec); both ends pick the best shared format automatically — AV1 over HEVC over H.264 — at up to 120 fps.
- QUIC with BBR: control messages, audio and video queue separately, so mouse input never waits behind a large frame; on a slow network the host caps bytes in flight and skips straight to the newest frame while the bitrate follows measured bandwidth. Besides the relay, both ends attempt a NAT-punched direct path — when it works, video stops detouring through the server, and the session falls back to the relay without dropping if the direct path breaks.
- Secure by default: sessions are end-to-end encrypted, so the relay only forwards bytes and cannot see the screen or keystrokes; the first connection needs the pairing code from the host’s tray, which never passes through the server. Control codes have brute-force protection, and the host always sees who is connected and can disconnect with one click.
- Deployment shapes: the
airhand-serverrelay deploys with Docker Compose and only registers codes, pairs sessions and forwards bytes. The controller can also run in Docker and be used from a browser (web console) with nothing installed on the machine you control from. - Platform coverage: Windows 10/11 (the host runs as a system service; lock screen, sign-in and UAC are controllable), macOS 13+ (needs screen-recording and accessibility permissions), Linux (X11 only, software encoding for now), Android 7+ both ways, plus the browser console; the interface and notices work in English and Chinese.
- Leaves nothing behind: the host is a tray icon without a WebView; everything worth keeping lives in one
config.toml, and uninstalling leaves no residue.
Typical use cases
- Replacing a commercial remote-control service: if you would rather not hand your screen contents to a third-party cloud, or you support family and team machines, a self-hosted relay keeps the data path yours. For lighter Android mirroring and control, the simpler existing path is escrcpy.
- Weak or long-distance networks: across carriers or continents, BBR congestion control with frame skipping holds up better than conventional TCP remote desktops; the README explicitly targets low latency.
- Managing several machines: the controller offers tabs and a multi-screen overview, saves machines you have connected to and reconnects automatically — useful when looking after several development boxes or home computers.
Quick start
The README’s flow has three steps: deploy your relay (airhand-server, one Docker Compose command), install the same program on the host and the controller, then pair by entering the 6-digit control code from the other side’s tray. Both ends connect out to the server, so the host needs no public IP or port forwarding; once a session starts, the two ends try a direct path automatically.
Mind the project stage: it self-describes as work in progress (0.2.3). Since protocol v9, client–server and host–controller each support a version range negotiated with capability bits; versions older than v9 are incompatible and detected with an error. Run it end to end between your own devices before relying on it.
Summary
Airhand brings self-hosted remote desktop down to a one-command Docker Compose relay, and its feature list covers what commercial tools offer: hardware encoding, broad platforms, clipboard sync, multiple monitors, audio. It is still early (0.2.3): the Linux host is X11 with software encoding only, and the Android host is watch-only until its accessibility service is enabled. GitHub’s API reported Rust, MIT, 1,240 stars, an unarchived repository, last pushed November 12, 2026, on November 14, 2026.
This entry is based on the README and docs; we did not install it or establish a session. Latency, image quality and weak-network behavior follow the project’s own descriptions, so verify between two of your own devices before adopting it.