notaadhil/gut-genug-distraction-tracker — explained in plain English
Analysis updated 2026-05-18
Get interrupted by video and audio automatically whenever you look down at your phone or away from your screen.
Use the calibration wizard so the tool learns your normal eye and head position without manual setup.
Load your own video clips into the assets folder to customize the alarm content.
Reset calibration with a key press so a different person can use the tool on the same computer.
| notaadhil/gut-genug-distraction-tracker | 0xustaz/streamgate | a-bissell/unleash-lite | |
|---|---|---|---|
| Stars | 1 | 1 | 1 |
| Language | Python | Python | Python |
| Setup difficulty | moderate | hard | hard |
| Complexity | 2/5 | 4/5 | 4/5 |
| Audience | general | developer | researcher |
Figures from each repo's GitHub metadata at analysis time.
Requires a working webcam and installing Python dependencies like OpenCV and MediaPipe before first use.
Gut Genug Distraction Tracker is a desktop program for Windows and Mac that uses your webcam to catch you when you get distracted, and interrupts you with a loud video and audio alarm until you look back at your screen. It watches your eyes and the angle of your head in real time. If you look down at your phone, glance away toward another monitor or the TV, or otherwise turn away from the screen, it immediately plays a video clip, described in the README as the Gut Genug anthem, along with sound. As soon as you look back at the computer, the video pauses and goes quiet on its own. Everything runs locally on your computer using your webcam, with nothing sent anywhere else. A startup wizard calibrates where your eyes and head normally sit when you look at the screen, so no manual configuration is needed, and it remembers that calibration for future launches unless you press a key to reset it. To avoid false alarms, the tool only counts a downward glance as distraction if both your eyes and your head tilt down together, so looking down briefly to type on a keyboard will not trigger it. The alarm volume also builds gradually, starting quiet and getting louder the longer you stay distracted, up to full volume. You can drop several video files into a folder and the app will pick one at random each time you get distracted. Under the hood it is written in Python and relies on OpenCV to read the webcam feed, a Google library called MediaPipe to track detailed points on your face and head position, and either a video playback library on Windows or AppleScript controlling QuickTime Player on Mac. Setup on Windows can be done by running a batch file that creates a virtual environment, installs the needed packages, and starts the tracker automatically. On Mac, setup is done manually through a few terminal commands before running the main script. The project credits an earlier similar tool as its inspiration.
A webcam based desktop app that plays a loud video alarm when it catches you looking away from your screen or doomscrolling, until you look back.
Mainly Python. The stack also includes Python, OpenCV, MediaPipe.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly general.
This repo across BitVibe Labs
double-check against the repo, no cap.