How yashn555/faceguard_pro works
FaceGuard Pro is an offline Windows security application. Its main workflow responds to workstation events by presenting a fullscreen lock, verifying a registered face or fallback password, and recording access attempts; failed attempts can trigger photo alerts and the configured shutdown policy. A separate Flask dashboard exposes logs, photos, settings, and friend management. The excerpts show daemon-to-dashboard startup and some database behavior; several feature-level links below are documented in the README rather than verified in unsampled implementation.
Main entry points: FaceGuard_Pro.py Access Verification · admin_dashboard.py Dashboard Features · dashboard.html Dashboard UI
Components 17
Workstation Protection
- Security Daemon
FaceGuard_Pro.py - Event Listener
FaceGuard_Pro.py - Fullscreen Lock
FaceGuard_Pro.py - Access Verification
FaceGuard_Pro.py - Attempt Policy
FaceGuard_Pro.py
Identity and Alerts
- Webcam Capture
FaceGuard_Pro.py - Face Registration
FaceGuard_Pro.py - Encrypted Face Storage
FaceGuard_Pro.py - Email Alerts
FaceGuard_Pro.py
Local Data
- Photo Backup
FaceGuard_Pro.py - Access Database
FaceGuard_Pro.py
Administration
- Dashboard Server
admin_dashboard.py - Dashboard UI
templates/dashboard.html - Dashboard Features
admin_dashboard.py
Other components
- Windows Events
- Gmail
- Administrator
Connections 20
- Windows Events → Event Listener: signals events
README.md - Event Listener → Security Daemon: notifies
README.md - Security Daemon → Fullscreen Lock: triggers lock
FaceGuard_Pro.py - Security Daemon → Dashboard Server: starts server
FaceGuard_Pro.py - Fullscreen Lock → Access Verification: requests verification
FaceGuard_Pro.py - Access Verification → Face Registration: checks registered faces
FaceGuard_Pro.py - Access Verification → Webcam Capture: captures face
FaceGuard_Pro.py - Access Verification → Attempt Policy: counts failures
README.md - Access Verification → Access Database: logs attempts
FaceGuard_Pro.py - Attempt Policy → Webcam Capture: captures failures
FaceGuard_Pro.py - Webcam Capture → Photo Backup: saves photos
README.md - Attempt Policy → Email Alerts: sends failure alert
README.md - Email Alerts → Gmail: sends email
README.md - Face Registration → Encrypted Face Storage: encrypts encodings
README.md - Dashboard Server → Dashboard UI: renders page
admin_dashboard.py - Administrator → Dashboard Server: opens dashboard
README.md - Dashboard Server → Dashboard Features: routes requests
admin_dashboard.py - Dashboard Features → Access Database: reads and updates
admin_dashboard.py - Dashboard Features → Photo Backup: serves photos
admin_dashboard.py - Dashboard Features → Face Registration: manages friends
admin_dashboard.py