How navaneeth1324/gazeshield works
GazeShield is an offline webcam privacy guard. Its main loop takes camera frames through face/iris and head-pose tracking, then evaluates the primary user’s attention and secondary faces. Confirmed intruders trigger security responses; away/absent states activate the privacy shield. The HUD presents gaze, attention, and alert status. The README documents snapshot logging, audio alerts, and optional workstation locking. Some main-loop calls are in omitted excerpts, so those links are supported by the README’s architecture description rather than claims of further source inspection.
Main entry points: main.py Application loop · security_handler.py Security responses · overlay.py Shield controller · hud.py HUD renderer
Components 14
Vision and attention
- Face and iris tracking
src/core/face_tracker.py - Attention estimator
src/core/gaze_estimator.py - Intruder detection
src/core/intruder_detector.py
Privacy and security
- Security responses
src/privacy/security_handler.py - Shield controller
src/privacy/overlay.py - Shield window
src/privacy/overlay_window.py - Incident snapshots
User interface
- HUD renderer
src/ui/hud.py - HUD drawing utilities
src/ui/visualizer.py
Other components
- User
- Webcam
- Application loop
main.py - Audio and workstation
- Live preview
Connections 14
- User → Webcam: faces
README.md - Webcam → Application loop: frames
main.py - Application loop → Face and iris tracking: processes frames
README.md - Application loop → Attention estimator: evaluates attention
README.md - Application loop → Intruder detection: checks secondary faces
README.md - Application loop → Security responses: triggers response
main.py - Application loop → Shield controller: controls shield
README.md - Application loop → HUD renderer: renders status
main.py - Security responses → Incident snapshots: saves images
src/privacy/security_handler.py - Security responses → Audio and workstation: alerts or locks
src/privacy/security_handler.py - Shield controller → Shield window: launches and commands
src/privacy/overlay.py - HUD renderer → HUD drawing utilities: uses drawing helpers
src/ui/hud.py - HUD renderer → Live preview: renders frame
- Shield controller → User: shields screen
README.md