TwinDesk Linux Wayland & X11 Setup

TwinDesk ships first-class native Linux x86_64 packages across Debian/Ubuntu APT, universal AppImage, Full KVM (polkit + login screen), Arch Linux (.pkg.tar.zst), and a declarative NixOS Flake module, pairing a C helper (XInput2/XTest on X11, evdev/uinput on Wayland) with the Rust tdv2 UDP input lane.

APT + NixOSSigned repo & declarative flake module
Wayland + X11evdev/uinput + GNOME Mutter display
Bundled ADBAndroid wireless debugging out of box
Lenovo ThinkPad laptop angled on a dark surface running the GNOME Linux desktop with backlit keyboard
On GNOME Wayland, TwinDesk uses Mutter's native Virtual remote monitor for extended displays and uinput for low-latency cursor and touchpad gestures.

Linux AppImage, .deb, Full KVM & Arch builds

Inspect the universal AppImage checksum below, or view Debian .deb, Full KVM, and Arch .pkg.tar.zst digests on the SHA-256 ledger.

Release packageTwinDesk-FullKVM-Setup-3.2.1.exe
Release tagv3.2.1
Verified byte size133,601,483 B (127.41 MiB)
GitHub repositoryInukaAsith/TwinDesk

Windows 10/11 x64 Full KVM edition. Adds a system service so shared mouse and keyboard drive UAC prompts (#210), admin windows, Ctrl+Alt+Del, and pre-login screens.

SHA-256 digest

608a73134814e137a40c072f77fd006826fd3f6ac17442c6030c6cf61547eaa6

Install or pairing sequence

Run TwinDesk-FullKVM-Setup-3.2.1.exe -> More info -> Run anyway -> Enable Full KVM service for UAC, Ctrl+Alt+Del & Windows lock screen

X11 vs Wayland capabilities & distro commands

Most features work identically across X11 and GNOME/KDE Wayland, with clear session boundaries documented below.

Feature AreaXorg (X11) SessionWayland Session (GNOME / KDE)
Mouse, keyboard & 2-finger touchpad gesturesXInput2 + XTest (immediate)evdev + uinput (one admin prompt during Setup, then log out & back in once; note issues #237 / #244 on tiling compositors Niri, Hyprland & COSMIC)
Extended virtual display (Share screen)Switches on spare XRandR GPU output via helper (Intel / AMD; unavailable on proprietary NVIDIA X11 driver)GNOME Wayland uses Mutter's built-in Virtual remote monitor (python3-gi + gstreamer1.0-pipewire); KDE Wayland guide included
Move windows & single Linux app windowsSupported (XDND edge strip + per-window capture)Requires an Xorg session (on Wayland, Move windows does nothing per issue #249)
Virtual webcam, Real gamepad & polkit loginv4l2loopback (TwinDesk Camera) + uinput (TwinDesk Gamepad); FullKVM drives polkit & DM loginSame v4l2loopback + uinput kernel modules (prompts for password once on first toggle)

Signed Debian, Ubuntu, Mint & Pop!_OS APT

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://inukaasith.github.io/twindesk-apt/twindesk.gpg | sudo tee /etc/apt/keyrings/twindesk.gpg > /dev/null
echo "deb [signed-by=/etc/apt/keyrings/twindesk.gpg] https://inukaasith.github.io/twindesk-apt stable main" | sudo tee /etc/apt/sources.list.d/twindesk.list
sudo apt update && sudo apt install twindesk playerctl

Adding playerctl on Ubuntu 24.04 / 26.04 ensures paired Android phones display Now Playing media controls on the Media page (issue #242).

NixOS Module, Arch Linux & Firewall UDP

# Run immediately with Nix Flakes:
nix run github:InukaAsith/TwinDesk

# NixOS configuration.nix (sets input + uinput groups):
programs.twindesk = { enable = true; user = "you"; };

On Fedora, openSUSE, or RHEL with firewalld active, allow 47800/tcp, 47801/udp, mdns (5353/udp for Android Wireless Debugging), and inbound UDP so the Rust tdv2 input lane upgrades from TCP fallback.

Linux & NixOS command generator

Switch between Debian/Ubuntu/Arch and NixOS to generate copy-ready APT, UFW, firewalld, and uinput snippets.

Desk session profile & protocol settings
# TwinDesk Desk Profile (v3.2.1 Verified)
Host Device:     macOS 13+ (Apple Silicon / Intel)
Paired Peer:     Windows 10/11 Desktop/Laptop
Transport Mode:  Same Wi-Fi (TLS 47800/tcp + Discovery 47801/udp + Rust tdv2 UDP)
Input Protocol:  UDP (tdv2, AES-256-GCM + HKDF-SHA256, 0-alloc Rust tdfast)
File Engine:     fx2 (Parallel HTTPS byte ranges, streamed hash check)
Emergency Home:  Ctrl+Alt+Command+Esc (or Scroll Lock / F14 cursor lock)
macOS Perms:     Screen Recording + Accessibility + Input Monitoring
Memory Usage:    ~147 MB resident (0.3% idle tray CPU)
Terminal, PowerShell & pairing commands
# Option A (Recommended): Install ready-to-open via Homebrew tap
brew install --cask inukaasith/twindesk/twindesk

# Option B: Clear Gatekeeper 'damaged / unverified' flag on .dmg install
xattr -dr com.apple.quarantine /Applications/TwinDesk.app
open /Applications/TwinDesk.app

Homebrew installs TwinDesk ready to launch, and brew upgrade --cask twindesk reopens it automatically so a headless Mac keeps mouse control.

Desk hardware for multi-OS KVM setups

Tested desk peripherals that pair cleanly with TwinDesk's Rust UDP input lane, wired ADB phone streaming, pen-pressure forwarding, and shared audio routing.

Logitech G305 Lightspeed Wireless Mouse

1 ms 2.4 GHz USB receiver and HERO 12K sensor built for crisp UDP tdv2 cursor crossing across Mac, Windows, and Linux monitors.

Check on Amazon

Syntech 16 ft USB-C Data Cable

High-bandwidth shielded USB-C link for wired Android ADB window streaming, tablet second-screen extension, and iPhone-to-Mac pairing.

Check on Amazon

Wacom Intuos Small Drawing Tablet

4,096 pressure levels forwarded through TwinDesk 3.0+ screen viewers into remote macOS and Windows creative applications.

Check on Amazon

FIFINE K669B Cardioid USB Microphone

Plug-and-play desktop condenser mic that shares cleanly across paired computers using TwinDesk's two-way Audio & Microphone toggle.

Check on Amazon

Affiliate disclosure: As an Amazon Associate, twindesk.wiki earns from qualifying purchases at no added cost to you.

Linux Wayland, X11, and NixOS FAQ

Verified answers on Mesh networking, resolved 2.5.x Linux bugs, and tiling Wayland compositors.

Does Linux join Multi-device TwinDesk Mesh?

Yes, when all Mesh devices are on the same local Wi-Fi / LAN. One-to-one sessions on Linux additionally support Bluetooth LE (via BlueZ), automatic Wi-Fi Direct groups (via NetworkManager), wired Android USB ADB, and Tailscale.

Were the older Linux glibc < 2.32 helper error (#149) and EPIPE log loop (#162) fixed?

Yes. Both issues from the 2.5.x branch (bundled helper requiring GLIBC_2.32+ and the console logger EPIPE disk write loop) were resolved upstream in 3.0.0+; always run v3.2.1 or newer.

Why doesn't cursor KVM move across monitors on Hyprland, Niri, or COSMIC Wayland (#237, #244)?

Standalone wlroots/Smithay tiling compositors handle pointer constraints and multi-output coordinate mapping differently from GNOME Mutter and KDE KWin. Check upstream issues #237 and #244 or test inside an Xorg / GNOME / KDE session when multi-monitor Wayland edge crossing is required.