Repository navigation
ConsoleRDP 1.0.0
ConsoleRDP 1.0.0
First public release. Windows-style RDP for Kubuntu 26.04 LTS amd64 with KDE Plasma 6 Wayland.
Features
- Single-seat takeover — RDP connects share the live Plasma session (not a new one). Local login evicts the RDP user; mstsc reconnect evicts the local user. Whoever authenticates last wins, just like Windows.
- NLA authentication — mstsc password = Linux password. No double-prompt.
- Color-correct mstsc rendering — patched
kpipewirewrites BT.601 H.264 VUI metadata so mstsc decodes YUV→RGB correctly. No more washed-out blacks. - Auto-unlock on reconnect — the daemon calls
loginctl unlock-sessionafter NLA validates, so reconnect skips the Plasma lockscreen. - VT switching — physical display flips to a "this seat is in use remotely" greeter on tty8 during RDP; flips back to Plasma on disconnect.
- Disconnect debounce — 1.5 s debounce in the watcher prevents spurious release events during mstsc's NLA TCP bounce.
Install on a fresh Kubuntu 26.04 box
curl -fsSL https://github.com/billsecond/consolerdp/releases/download/v1.0.0/install-remote.sh | sudo bashOr manually:
git clone https://github.com/billsecond/consolerdp.git
cd consolerdp
sudo ./install.sh --user $(whoami)See INSTALL.md for the full compatibility matrix and options.
What's in the tarball
- 7 prebuilt
.debpackages (release/*.deb) - Source tree (orchestrator + helper scripts in
bin/, systemd units, config templates) - Patches against upstream
krdp 6.6.4(8 patches) andkpipewire 6.6.4(1 patch) install.sh,uninstall.sh,INSTALL.md,README.md
Compatibility
| Target | Supported? |
|---|---|
| Kubuntu 26.04 LTS amd64 | ✅ |
| Ubuntu 26.04 + kubuntu-desktop | |
| Anything else | ❌ rebuild required |
Known issues
See docs/known-issues.md in the repo.