Spawn a VNC-powered virtual monitor in Hyprland (Linux)
Use any device — old laptop, Raspberry Pi, tablet — as a second screen for your Wayland desktop!
- Creates a headless virtual monitor in Hyprland
- Shares the virtual monitor over VNC
- Works with any VNC viewer on any platform
- Great for multi-PC setups or repurposing old hardware
-
Configure Hyprland
- Edit your
hyprland.confand define a new monitor (e.g.HEADLESS-1) - Set resolution to match the remote screen (recommended)
Example:
monitor=HEADLESS-1,1920x1080@60,0x0,1 - Edit your
-
Edit
virtmon.sh- Adjust values in the
# CONFIGsection (monitor name, resolution, etc.)
- Adjust values in the
-
Install dependencies
sudo pacman -S wayvnc
-
Find your LAN IP
ip a | grep inet -
Run the script
./virtmon.sh
-
Connect from another PC
- Open a VNC viewer (RealVNC, TigerVNC, etc.)
- Enter IP address shown in terminal
- Set it to full-screen
-
Stop when done
- Press
Ctrl+Cin terminal to stop the virtual monitor and VNC server
- Press
- 🧠 Use an old laptop as a wireless second screen
- 🍓 Raspberry Pi works great as a cheap thin-client
- 📱 Even a tablet or smartphone with a VNC viewer app can be used as an external display
- Arch Linux
- Hyprland v0.49.0
- NVIDIA proprietary drivers v575
- WayVNC 0.9.1
This project is licensed under the MIT License.