What is gdev-monitor?

Gdev-Monitor turns a Linux laptop into an automated streaming station. It creates a virtual monitor on Linux and uses it to broadcast a real extended desktop, either locally or remotely, using three underlying tools called VKMS, Sunshine, and Moonlight. The project automates several fiddly setup steps for you: creating the virtual screen, configuring the firewall, managing the user's audio routing, and loading custom profiles under the X11 graphical environment. It also includes a Telegram bot for remote control, with commands like turning on the extended desktop and audio routing, switching back to laptop mode, or launching a profile tuned for watching media on a TV. The project notes it is prepared for future integration with voice assistants such as Alexa, though that is not built yet. Under the hood, the virtual screen is created through a Linux kernel module called VKMS, and the desktop is extended using the xrandr command so windows can be moved freely across both screens. Audio is isolated and redirected through pactl, which works with either PulseAudio or PipeWire, and the project is careful to only ask for elevated sudo permissions for system level tasks like loading the kernel module or adjusting the firewall. To use it, you clone the repository, make the install and script files executable, and run the installer, which sets up VKMS, the firewall rules, and the required permissions automatically. From there, a single command switches the machine into TV mode or back into laptop mode. The project is written in Shell and Python, requires Linux, X11, and Python 3, and depends on a handful of Linux tools including xrandr, modprobe, ufw, and pactl, plus the third party Sunshine and Moonlight streaming software. The project is released under the MIT license, so it is free to use, modify, and redistribute as long as the license terms are respected.