u/Alejandrominor

Hey everyone,

I built HyprWatch, a Python-based tool for Hyprland that monitors a specific monitor and executes a command or script the moment a visual change is detected.

https://reddit.com/link/1t1grfj/video/0e2i119prnyg1/player

The Problem:

I often handle long-running data processes (like massive database imports or long renders) where I can't easily hook into an exit code. Instead of sitting there waiting or coming back every 5 minutes to check if it's done, I run HyprWatch on that monitor and step away from the computer.

It’s perfect for detecting when a progress bar finishes or any UI state changes on the screen. I personally use it to trigger a Telegram notification via a .sh script, so I get an alert on my phone the second the task is finished, but the default option is a simple desktop notification.

Tool information:

The tool is designed to tolerate a certain amount of noise or minor pixel differences. This is important to handle loading animations or small UI jitters so it doesn't trigger false alerts by mistake. It takes periodic screenshots and compares them based on the threshold and noise levels you define.

This project is currently in development. At the moment, it only supports monitoring a full monitor, but I plan to expand these options soon.

This is my repo: https://github.com/AlejandroMinor/HyprWatch