How vineshbhaskar/screenprivacysystem works
This is a desktop shoulder-surfing protection app with a FastAPI alert-logging backend. The main workflow is webcam capture, multi-face and iris-gaze analysis, primary-user comparison, then a threat decision that can trigger privacy responses and optionally log an alert. The client is largely implemented in one source file, so several distinct responsibilities share its path. The README documents the client-to-server alert flow; the server excerpt shows database writes. Client implementation details beyond the supplied excerpts are represented only where documented.
Main entry points: screen_privacy.py Threat Decision · main.py FastAPI Alert Endpoint
Components 16
Threat Detection
- Camera Monitoring
client_app/screen_privacy.py - Multi-Face Detection
client_app/screen_privacy.py - Iris Gaze Analysis
client_app/screen_privacy.py - Primary User Selection
client_app/screen_privacy.py - Threat Decision
client_app/screen_privacy.py - Alert Cooldown
client_app/screen_privacy.py
Desktop Client
- Tkinter Dashboard
client_app/screen_privacy.py - Spotlight Overlay
client_app/screen_privacy.py - Screen Dimming
client_app/screen_privacy.py - Camera Preview
client_app/screen_privacy.py - Push Notifications
client_app/screen_privacy.py
Alert Backend
- FastAPI Alert Endpoint
server/main.py - Alert Log Writer
server/main.py
Other components
- Desktop User
- Webcam
- PostgreSQL Alerts
Connections 15
- Desktop User → Tkinter Dashboard: configures
README.md - Tkinter Dashboard → Camera Monitoring: starts monitoring
client_app/screen_privacy.py - Webcam → Camera Monitoring: provides frames
README.md - Camera Monitoring → Multi-Face Detection: processes frames
README.md - Multi-Face Detection → Iris Gaze Analysis: analyzes eyes
README.md - Iris Gaze Analysis → Primary User Selection: compares faces
README.md - Primary User Selection → Threat Decision: identifies bystanders
README.md - Threat Decision → Alert Cooldown: checks cooldown
README.md - Threat Decision → Spotlight Overlay: activates
README.md - Threat Decision → Screen Dimming: activates
README.md - Threat Decision → Camera Preview: triggers preview
README.md - Threat Decision → Push Notifications: sends alert
README.md - Threat Decision → FastAPI Alert Endpoint: posts alert
README.md - FastAPI Alert Endpoint → Alert Log Writer: routes to
server/main.py - Alert Log Writer → PostgreSQL Alerts: writes event
server/main.py