How jayesh-cmd/doomscrolling-stop works
Doomscroller Controller is a single-file macOS webcam application. Its main loop captures frames, uses MediaPipe face landmarks and OpenCV-based head-pose/eye measurements to classify looking away, applies frame-count thresholds, and starts or stops a QuickTime video alarm. The preview overlays show face, gaze, and alarm status; ESC exits and releases the camera. The source excerpt shows these responsibilities, while README documents the user workflow and permissions. There are no separate domain modules or persistent stores.
Main entry points: main.py Webcam loop
Components 7
Camera and gaze
- Webcam loop
main.py - Face landmarks
main.py - Gaze classification
main.py
Alarm control
- Frame thresholds
main.py - QuickTime Player
Live preview
- Status preview
main.py
Other components
- Viewer
Connections 7
- Viewer → Webcam loop: faces camera
README.md - Webcam loop → Face landmarks: processes frames
main.py - Face landmarks → Gaze classification: provides landmarks
main.py - Gaze classification → Frame thresholds: updates gaze state
main.py - Frame thresholds → QuickTime Player: starts or stops
main.py - Webcam loop → Status preview: renders overlay
main.py - Viewer → Status preview: views status
README.md