VallierDev/uu-remote-linux

Worth a look if you already use UU Remote on Windows or Mac and wanted the same experience on a Linux box. It is not a polished product, and it is not affiliated with NetEase.

The problem

You want to reach a Linux desktop or server from your phone, a Mac, or a Windows PC using the client you already installed. NetEase UU Remote ships official clients for those platforms but has never published a Linux host, so the Linux machine simply cannot appear in the device list. This project logs into your own UU account by QR code, registers the Linux machine as a host, and lets the official client connect to it. After that, remote desktop, file transfer, terminal and port mapping behave roughly the way they do against an official Windows host.

What's different

This is a native Rust program, not a Wine wrapper or a reimplementation of the client UI. It speaks the host-side protocol directly, so the thing you connect with is still the official app on your phone or Mac. That is the central design choice: the project largely refuses to replace the vendor's client and instead fills the missing platform slot. Video is H.264, with NVENC when an NVIDIA GPU is present and libx264 otherwise; audio is Opus over PulseAudio or PipeWire. X11 hosts can genuinely change desktop resolution through xrandr, and the project reports true 4:4:4 output on the NVENC and libx264 paths.

The trade-off is scope. Wayland support is uneven: Hyprland and niri go through experimental native protocols, while GNOME and KDE rely on xdg-desktop-portal, with fixed resolution on the portal path and single-screen capture as the default outside opt-in multi-monitor modes. HDR, virtual displays, microphone from controller to host, and control of the Linux system login screen are all listed as unimplemented. There is also an experimental uuremote-viewer for using Linux as the controlling side, but that is secondary to the host role.

Who should try it

It fits a user who already has a UU account and an official client on another device, and wants to reach a Linux desktop or headless server without adopting a different remote-desktop stack. A headless NAS is a good example: the project documents a Docker deployment path for Synology/NAS without a desktop, exposing terminal, file transfer and port mapping.

It is a poor fit if you need HDR, virtual monitors, a pristine Wayland experience on every compositor, or remote control of the Linux login screen before anyone has logged in. If your main machine runs Hyprland or niri, expect an experimental path; if it runs a mainstream X11 desktop such as GNOME on Ubuntu 24.04, that is the configuration the author reports using daily, while several others are only verified in VMs.

Requirements and limitations

You need an existing UU account and the official client on the controlling end, because the project does not replace it. Installation is available as a .deb for x86_64/aarch64 or a release tarball for other distributions, and a Docker image for NAS deployments; the README covers these paths in detail. On Xfce-like desktops that do not pass the display environment to the user service, you must set DISPLAY yourself.

On Wayland, keyboard and mouse injection via the portal can drop symbols under some layouts; the project recommends granting the logged-in user access to /dev/uinput instead, which is a udev rule and does not happen automatically from the deb. Ongoing upkeep matters too: display layout is read at host startup for multi-monitor modes, so plugging or unplugging monitors requires restarting the service, and the diagnostics command uuremote-server doctor is the intended first step when filing an issue. The project states it is a personal-interest effort with no affiliation with NetEase, so treat compatibility with future official client updates as something to watch rather than assume.

HotRepo's take

HotRepo has only two recorded board dates: the repository was 10 days old and sat at #21 on the NEW-REPOSITORY board for rust on 2026-10-25 with 418 total stars. That is a snapshot, not a growth series; persistence cannot yet be judged. Before committing, check the supported-desktop table against your actual compositor and verify whether the X11 or Wayland path matches how you log in.