notaadhil/gut-genug-distraction-tracker

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.