LuxWatch is a lightweight, system-tray utility for Linux (KDE Plasma 6 / Wayland) that automatically manages monitor brightness based on the running application.
It is designed for gaming setups where you want your main monitor to be 100% brightness while gaming, but dimmed to 70% (or lower) for desktop use to reduce eye strain.
- Profile Support: Create custom profiles for "Horror Games" (secondary screens off), "Work", or "Movies".
- Smart Detection: Detects games even if they are running inside Flatpak, Bubblewrap, or Steam Proton.
- Multi-Monitor: Individual control for every connected display.
- Tray Icon: Active/Inactive states indicated by the tray icon color.
- Safe: Runs in user-space using standard KDE tools (
kscreen-doctor).
-
Clone this repository:
git clone https://github.com/YOUR_USERNAME/LuxWatch.git cd LuxWatch -
Run the installer:
chmod +x install.sh ./install.sh
-
Log out and log back in (or start it manually from your application menu).
- Python 3
- PyQt6
- KDE Plasma 6 (Wayland)
kscreen-doctor(Standard on KDE)ddcutil(Optional, for hardware debugging)
MIT
Note: This application was mostly vibecoded. It works on my machine, and it should work on yours, but it was built with intuition and grit rather than strict enterprise specifications. Use at your own risk (and enjoyment).