Case study
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.
- Targets
- App · Protocol
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Sources reviewed
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.
About this entry
The description was reviewed against primary sources.
Primary sources
- README.en.md GitHub · VallierDev/uu-remote-linux · Revision 696cf10
- README.md GitHub · VallierDev/uu-remote-linux · Revision 696cf10
- AGENTS.md GitHub · VallierDev/uu-remote-linux · Revision 696cf10
- Cargo.toml GitHub · VallierDev/uu-remote-linux · Revision 696cf10
- LICENSE GitHub · VallierDev/uu-remote-linux · Revision 696cf10
- src/control_protocol.rs GitHub · VallierDev/uu-remote-linux · Revision 696cf10
- src/protocol.rs GitHub · VallierDev/uu-remote-linux · Revision 696cf10
- src/initialization.rs GitHub · VallierDev/uu-remote-linux · Revision 696cf10
- src/desktop_control_tests.rs GitHub · VallierDev/uu-remote-linux · Revision 696cf10
- src/webrtc_lifecycle_tests.rs GitHub · VallierDev/uu-remote-linux · Revision 696cf10
- src/viewer/wire.rs GitHub · VallierDev/uu-remote-linux · Revision 696cf10
- src/viewer/tests.rs GitHub · VallierDev/uu-remote-linux · Revision 696cf10
- .github/workflows/ci.yml GitHub · VallierDev/uu-remote-linux · Revision 696cf10
More in Apps
- TCLimate: reconstructing selected TCL Home cloud controls · Case study
- Browserbase plugin: re-hosting Claude in Chrome’s browser bridge · Case study
- Visor: an independent Ray-Ban Meta glasses client · Case study
- wine-uwp: running packaged Windows Store apps on a patched Wine · Case study
- RKD Telemetry Extractor: decoding Race-Keeper track-day recordings · Case study
- Elgato HDR: a userspace capture path for the Elgato 4K X’s 10-bit mode · Case study