Guide: Connect to Hyprland via RDP

[MuNeNICK]

Background

Omarchy (Hyprland-based) can be accessed remotely via VNC (WayVNC), but Windows users may prefer using the built-in RDP client.
By leveraging xrdp with its VNC backend, RDP can be bridged to Hyprland through WayVNC.

RDP → xrdp → WayVNC → Hyprland

Hyprland lacks native RDP support, so xrdp uses libvnc.so to forward frames to WayVNC.

---

Setup

Install dependencies

sudo pacman -S wayvnc nasm

Configure Hyprland headless output

hyprctl output create headless VNC-1
hyprctl keyword monitor "VNC-1,1920x1080@60,auto,1"
wayvnc -o VNC-1 127.0.0.1 5900

Build and configure xrdp

git clone https://github.com/neutrinolabs/xrdp.git
cd xrdp
git checkout 4b2155b6cf80c0411ffe8b5f1f7e3e4fae09e1a8
./bootstrap && ./configure && make
sudo make install

Edit /etc/xrdp/xrdp.ini:

[Xvnc]
name=Xvnc
lib=libvnc.so
pamusername=ask
pampassword=ask
ip=127.0.0.1
port=5900
security_level=0
depth=24

Then start the service:

sudo systemctl enable --now xrdp

---

Connect via Windows RDP

• Open “Remote Desktop Connection”
• Session: Xvnc
• Use your Linux username/password
  If successful, you will see the Hyprland session.

---

Notes

• The build above uses a specific commit for RFB 3.7 compatibility with WayVNC.

• Dynamic resolution changes may cause instability.

• Ongoing discussion for native WayVNC integration:

  • Add "labwc over VNC" backend (Wayland) neutrinolabs/xrdp#3587
  • So.. Lets talk about Wayland (long term feature request and discussion) neutrinolabs/xrdp#2637

[MuNeNICK]

Most people will probably be better off connecting directly to WayVNC using a VNC client, rather than using the xrdp + WayVNC solution.
The steps for that method are shown below.

#1284