# UU Remote on Linux: an unofficial protocol implementation

> Implements an unofficial native Linux host for NetEase UU Remote, using protocol behavior the maintainer says was recovered from official-client traffic and shipped programs. The Rust implementation connects selected desktop, input and auxiliary-tool channels to Linux services; an additional Linux viewer remains experimental. The author attributes development to Claude and Codex, without establishing REA use.

- Type: Case study
- Targets: App · Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-10-18
- Added to the catalog: 2026-10-18
- Original resource: <https://github.com/VallierDev/uu-remote-linux>
- Primary source: <https://github.com/VallierDev/uu-remote-linux/blob/696cf10e334b2e7fe1afcb698b354c09ee328447/README.en.md>
- Catalog page: <https://awesomerea.org/resources/uu-remote-linux-protocol-case/>
- Record JSON: <https://awesomerea.org/resources/uu-remote-linux-protocol-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/uu-remote-linux-protocol-case/index.md)

## Requirements & limits

- **Prerequisites:** The host needs Linux, stable Rust, a C toolchain, pkg-config, X11 development libraries and FFmpeg. GTK3 supports graphical login; the optional viewer also needs SDL2. Wayland/portal builds require additional libraries and authorized desktop access. Dependencies vary by feature.
- **Prerequisites:** UU cloud services remain required; the host and experimental viewer interoperate with supported official clients and hosts. Account connections use the user’s own authorized account; experimental remote assistance requires an explicitly enabled host and recipient-provided connection details. The project is unaffiliated with NetEase.
- **Scope:** Reviewed version 0.2.8 implements selected protocol formats and session behavior in native Rust with small C components, without Wine or bundled NetEase binaries. The additional Linux viewer is experimental. Cargo.toml declares GPL-3.0-or-later; dependencies and official clients/services retain separate terms. This is not recovered vendor source or a replacement cloud backend.
- **Testing evidence:** Public parsing and initialization code has synthetic checks for malformed inputs, capability replies and echo correlation. Local/virtual WebRTC peers test pending-desktop responses, independent tool connections and session isolation. These are implementation checks.
- **Testing evidence:** The README reports real-machine GNOME/X11 use and selected GNOME Wayland checks; other desktop coverage is largely virtual-machine based. Its viewer acceptance matrix is explicitly partial, with different official-host coverage for clipboard, audio, codecs and keyboards. These remain author-reported observations.
- **Limits:** Wayland remains experimental, with single-screen and resolution/recovery limits. Multi-monitor switching is under development; HDR, privacy-screen mode, microphone forwarding and the Linux pre-login screen are unsupported. Restrictive-network relay behavior is not thoroughly tested.

## Primary sources

1. <https://github.com/VallierDev/uu-remote-linux/blob/696cf10e334b2e7fe1afcb698b354c09ee328447/README.en.md>
2. <https://github.com/VallierDev/uu-remote-linux/blob/696cf10e334b2e7fe1afcb698b354c09ee328447/README.md>
3. <https://github.com/VallierDev/uu-remote-linux/blob/696cf10e334b2e7fe1afcb698b354c09ee328447/AGENTS.md>
4. <https://github.com/VallierDev/uu-remote-linux/blob/696cf10e334b2e7fe1afcb698b354c09ee328447/Cargo.toml>
5. <https://github.com/VallierDev/uu-remote-linux/blob/696cf10e334b2e7fe1afcb698b354c09ee328447/LICENSE>
6. <https://github.com/VallierDev/uu-remote-linux/blob/696cf10e334b2e7fe1afcb698b354c09ee328447/src/control_protocol.rs>
7. <https://github.com/VallierDev/uu-remote-linux/blob/696cf10e334b2e7fe1afcb698b354c09ee328447/src/protocol.rs>
8. <https://github.com/VallierDev/uu-remote-linux/blob/696cf10e334b2e7fe1afcb698b354c09ee328447/src/initialization.rs>
9. <https://github.com/VallierDev/uu-remote-linux/blob/696cf10e334b2e7fe1afcb698b354c09ee328447/src/desktop_control_tests.rs>
10. <https://github.com/VallierDev/uu-remote-linux/blob/696cf10e334b2e7fe1afcb698b354c09ee328447/src/webrtc_lifecycle_tests.rs>
11. <https://github.com/VallierDev/uu-remote-linux/blob/696cf10e334b2e7fe1afcb698b354c09ee328447/src/viewer/wire.rs>
12. <https://github.com/VallierDev/uu-remote-linux/blob/696cf10e334b2e7fe1afcb698b354c09ee328447/src/viewer/tests.rs>
13. <https://github.com/VallierDev/uu-remote-linux/blob/696cf10e334b2e7fe1afcb698b354c09ee328447/.github/workflows/ci.yml>

## More in Apps

- [TCLimate: reconstructing selected TCL Home cloud controls](https://awesomerea.org/resources/tclimate-cloud-controls-case/index.md) · Case study
- [Browserbase plugin: re-hosting Claude in Chrome’s browser bridge](https://awesomerea.org/resources/browserbase-claude-chrome-bridge-case/index.md) · Case study
- [Visor: an independent Ray-Ban Meta glasses client](https://awesomerea.org/resources/visor-ray-ban-meta-client-case/index.md) · Case study
- [wine-uwp: running packaged Windows Store apps on a patched Wine](https://awesomerea.org/resources/wine-uwp-store-apps-case/index.md) · Case study
- [RKD Telemetry Extractor: decoding Race-Keeper track-day recordings](https://awesomerea.org/resources/rkd-telemetry-extractor-case/index.md) · Case study
- [Elgato HDR: a userspace capture path for the Elgato 4K X’s 10-bit mode](https://awesomerea.org/resources/elgato-hdr-uvc-capture-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.