How ahmedsheikh27/sleep_detector works
Sleep Alarm is a single-camera drowsiness monitor. The main workflow captures and displays webcam frames, detects facial landmarks, computes an average eye-aspect ratio, tracks sustained closure, and plays or stops an alarm; pressing q exits. The repository also contains a separate live face-mesh viewer. The main workflow is visible in app/main.py, while the README documents its threshold behavior and capabilities. The graph keeps the main loop’s responsibilities distinct; several nodes share its source file because they are implemented there.
Main entry points: main.py Alarm loop · fmesh.py Mesh viewer · face_mesh.py Face mesh detector · ears.py Eye aspect ratio
Components 14
Alarm runtime
- Alarm loop
app/main.py - Frame capture
app/main.py - Frame preparation
app/main.py - Closure tracking
app/main.py
Face detection
- Face mesh detector
app/detectors/face_mesh.py - Eye landmarks
app/main.py - Eye aspect ratio
app/utils/ears.py - Mesh viewer
app/detectors/fmesh.py
Display and audio
- Alarm control
app/main.py - Alarm audio
app/alarm.mp3 - Camera display
app/main.py
Other components
- User
- Webcam
- MediaPipe
Connections 14
- User → Alarm loop: starts and quits
README.md - Alarm loop → Frame capture: opens camera
app/main.py - Frame capture → Webcam: reads frames
app/main.py - Alarm loop → Frame preparation: flips and converts
app/main.py - Frame preparation → Face mesh detector: processes frame
app/main.py - Face mesh detector → MediaPipe: uses
app/detectors/face_mesh.py - Alarm loop → Eye landmarks: reads results
app/main.py - Alarm loop → Eye aspect ratio: computes eye ratios
app/main.py - Alarm loop → Closure tracking: tracks closed frames
app/main.py - Alarm loop → Alarm control: starts or stops
app/main.py - Alarm loop → Alarm audio: loads
app/main.py - Alarm loop → Camera display: shows frame
app/main.py - Mesh viewer → MediaPipe: uses
app/detectors/fmesh.py - Mesh viewer → Webcam: reads frames
app/detectors/fmesh.py