# uu-remote-linux · Unofficial Linux host for NetEase UU Remote [简体中文](README.md) | **English** > **A note first** > > NetEase UU Remote (网易 UU 远程) is a great remote-desktop tool, but there is no Linux version on its > official website. So, with the help of Claude and Codex, I wrote this open-source Linux host: install it, > and you can control your Linux machine from the official Mac / Windows / mobile UU Remote clients. > > This is a personal hobby project. **It is not affiliated with NetEase and is not an official client.** > If NetEase considers this project infringing or inappropriate, please DM me on X > **[@ai_fengshou](https://x.com/ai_fengshou)** and I will take it down right away.

The QR login window shown on first run (QR code blurred). The UI is in Chinese, like the official app.
## What it is - A native Linux program written in Rust: no Wine, no Windows or macOS components. - Log in by scanning a QR code with your own UU Remote account. The Linux machine then appears in the official clients' device list and is used just like a Windows host. - **Host only.** To control other machines you still use the official Mac / Windows / mobile apps. ## Features | Feature | Notes | |---|---| | QR login | GTK login window (or a terminal QR code with `login --no-gui`); expired codes refresh automatically; the service opens the login window by itself when credentials are missing or expired | | Remote desktop | H.264 video, NVENC hardware encoding on NVIDIA GPUs, libx264 otherwise; the viewer draws its local pointer, so there is no double cursor | | Mouse / keyboard | Absolute and relative motion, clicks, wheel, keys; no spurious key repeat on high-latency links | | Pointer shape | Remote cursor shape is mirrored to the viewer (X11) | | Clipboard | Two-way text sync | | Quality / frame rate / resolution | Auto, Original 20M, Ultra 8M, HD 2M, custom; 30/60/90/144 fps; "other resolutions" are scaled by the encoder, the host monitor is left untouched | | Sound | System audio captured from PulseAudio / PipeWire and sent as Opus | | File transfer | Upload, download (including folders), create folder, rename, delete | | Terminal | The official "Terminal" tool, PTY sessions, multiple sessions, rename | | Lock state and auto unlock | Lock state is reported to the viewer; with "auto unlock" enabled in the client, the password is verified with PAM and the session is unlocked | | Lock after remote session | Stored on the host, so it still applies after reconnecting | | Mute host while controlled | Host speakers are muted while the viewer still hears the sound; the previous mute state is restored afterwards | | System actions | Lock, show desktop, task manager (system monitor), reboot, shut down | | Reconnects | Every tool window has its own connection; they do not disturb each other | ## Supported Linux desktops | Desktop | Display protocol | Status | Build | |---|---|---|---| | GNOME (Ubuntu 24.04) | X11 / Xorg | ✅ In daily use on real hardware; every feature above accepted | default | | KDE Plasma | X11 | ✅ Tested in a VM | default | | Xfce | X11 | ✅ Tested in a VM | default | | Cinnamon / MATE | X11 | ✅ Tested in a VM | default | | Hyprland | Wayland (native wlroots protocols) | 🧪 Experimental, tested in a VM (some features limited, see below) | `--features wayland` | | GNOME / KDE Plasma | Wayland (xdg-desktop-portal) | 🧪 Experimental, tested in a VM (some features limited, see below) | `--features wayland,portal` | Apart from GNOME on X11, these desktops have been tested in virtual machines so far. If something goes wrong on real hardware, please [open an issue](../../issues) with your distribution, desktop, GPU and the relevant lines from `journalctl --user -u uuremote-native.service`. Wayland limits: single screen, fixed resolution. The portal backend does not support clipboard, screen wake or dynamic resolution yet. On the first connection the desktop asks for "Remote Desktop / Screen Sharing" permission; the permission is remembered once granted. ## Not implemented / not supported | Feature | Status | |---|---| | Switching between multiple monitors | In progress | | True color (4:4:4) | Not implemented; not declared in the handshake, so the client does not enable it | | HDR | Not implemented | | Super screen / virtual display | Not implemented | | Privacy screen on the host | Not implemented | | Microphone (viewer audio played on the host) | Not implemented (needs a virtual sound card) | | Plugins such as the WoW queue notifier | Not supported; the client is told that no plugins exist | | Access before login (greeter / no user logged in) | Not supported; only an already logged-in desktop session can be controlled | | Port mapping | Code exists, not yet accepted | | Relay connections on restrictive networks | Uses the ICE servers provided by the UU cloud; complex network setups are not thoroughly tested | | Acting as a viewer (controlling other machines from Linux) | Out of scope | ## Installation ### 1. Dependencies (Ubuntu / Debian) ```sh sudo apt install build-essential pkg-config \ libx11-dev libxext-dev libxtst-dev libxfixes-dev \ libgtk-3-dev ffmpeg # optional: Wayland backend sudo apt install libwayland-dev libxkbcommon-dev wl-clipboard # optional: GNOME/KDE portal backend sudo apt install libglib2.0-dev libpipewire-0.3-dev ``` - A Rust toolchain is required (