Skip to content

LinuxRenaissance/VirtMon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 

Repository files navigation

🖥️ VirtMon

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!


📋 Features

  • 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

🛠️ Instructions

  1. Configure Hyprland

    • Edit your hyprland.conf and define a new monitor (e.g. HEADLESS-1)
    • Set resolution to match the remote screen (recommended)

    Example:

    monitor=HEADLESS-1,1920x1080@60,0x0,1
  2. Edit virtmon.sh

    • Adjust values in the # CONFIG section (monitor name, resolution, etc.)
  3. Install dependencies

    sudo pacman -S wayvnc
  4. Find your LAN IP

    ip a | grep inet
  5. Run the script

    ./virtmon.sh
  6. Connect from another PC

    • Open a VNC viewer (RealVNC, TigerVNC, etc.)
    • Enter IP address shown in terminal
    • Set it to full-screen
  7. Stop when done

    • Press Ctrl+C in terminal to stop the virtual monitor and VNC server

💡 Extra Ideas

  • 🧠 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

🧪 Tested on

  • Arch Linux
  • Hyprland v0.49.0
  • NVIDIA proprietary drivers v575
  • WayVNC 0.9.1

🧵 License

This project is licensed under the MIT License.

About

Spawns a VNC-server-powered headless monitor on Hyprland

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages