guadalupe182/gdev-monitor — explained in plain English
Analysis updated 2026-05-18
Turn a Linux laptop into a virtual second monitor that streams to a TV or tablet.
Switch between laptop mode and an extended TV streaming mode with one command.
Control the streaming setup remotely through Telegram bot commands.
Automate firewall, audio routing, and virtual display setup on Linux Mint or Ubuntu.
| guadalupe182/gdev-monitor | 100/dotfiles | abdellaouiamir/palworld-server | |
|---|---|---|---|
| Stars | 1 | 1 | 1 |
| Language | Shell | Shell | Shell |
| Last pushed | — | 2016-11-18 | — |
| Maintenance | — | Dormant | — |
| Setup difficulty | moderate | easy | moderate |
| Complexity | 3/5 | 1/5 | 3/5 |
| Audience | developer | developer | ops devops |
Figures from each repo's GitHub metadata at analysis time.
Requires Linux with X11, several system tools like xrandr and pactl, and the third-party Sunshine and Moonlight apps.
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.
A Shell and Python toolkit that turns a Linux laptop into a wireless extended-desktop streaming station using a virtual monitor.
Mainly Shell. The stack also includes Shell, Python, VKMS.
MIT license: free to use, modify, and distribute as long as you keep the license terms.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.