How jam9973/blink-reminder works
This is a desktop blink-monitoring prototype: it reads webcam frames, derives eye measurements, counts blinks over a rolling 60-second window, and alerts when the count stays below a configurable target. The principal flow is frame capture and EAR measurement, C-based blink and alert decisions, then on-screen feedback and optional measurement logging. Settings cover camera and thresholds; the README also documents landmark display, keyboard/mouse controls, and CSV/JSON records. The source index confirms key Python imports; some UI-to-worker wiring is documented only at product level, so uncertain links are omitted.
Main entry points: blink_app.py Desktop App · camera_worker.py Frame Analysis · engine.py Python Bridge · app_settings.py App Settings
Components 13
Capture and Settings
- Frame Analysis
camera_worker.py - App Settings
app_settings.py - Saved Settings
app_settings.py
Blink Decisions
- Python Bridge
engine.py - Blink Engine
blink_engine.c - C API
blink_engine.h
App and Records
- Desktop App
blink_app.py - Measurement Logger
measurement_log.py - CSV Records
measurement_log.py - On-screen Alert
blink_app.py
Other components
- User
- Webcam
- MediaPipe
Connections 12
- Webcam → Frame Analysis: provides frames
- Frame Analysis → MediaPipe: detects landmarks
- Frame Analysis → App Settings: imports
camera_worker.py - Frame Analysis → Python Bridge: imports
camera_worker.py - Desktop App → Python Bridge: imports
blink_app.py - Desktop App → Measurement Logger: imports
blink_app.py - Python Bridge → Blink Engine: calls via ctypes
- Blink Engine → C API: implements
blink_engine.c - Desktop App → On-screen Alert: displays
blink_app.py - Desktop App → User: accepts controls
- Measurement Logger → CSV Records: writes
measurement_log.py - App Settings → Saved Settings: persists
app_settings.py