Configuration Reference
ScreenStop configuration is managed centrally from the Dashboard and pushed to stations automatically. Most settings do not require touching the local workstation.
Dashboard-Managed Settings
These settings are configured in the Dashboard and synced to each station every few seconds.
| Setting | Description | Default |
|---|---|---|
detection_mode |
Active detection modes (see below) | All enabled |
lock_delay_seconds |
Seconds before screen locks after a threat | 0 |
phone_confidence |
YOLO confidence threshold for phone detection | 0.5 |
face_confidence |
InsightFace confidence threshold for face matching | 0.45 |
LOG_LEVEL |
Logging verbosity (DEBUG, INFO, WARNING, ERROR) |
INFO |
debug_mode |
Stream logs to dashboard in real time | false |
Detection Modes
| Mode | Description |
|---|---|
| Phone Detection | Locks screen when a phone is pointed at the monitor |
| Unauthorized Person | Locks when an unrecognized face is detected |
| Shoulder Surfing | Locks when more than one face is detected |
| Unattended Screen | Locks when no face is detected for a configured duration |
Modes can be enabled/disabled individually from the Dashboard.
Face Enrollment
Face enrollment is required for the Unauthorized Person and Shoulder Surfing modes to function.
- Right-click the ScreenStop menu/tray icon
- Select Open Control Center
- Click Train Face
- Follow the on-screen instructions (captures 5–10 photos)
- Training completes in seconds
Face data is stored locally at:
=== "macOS"
~/Library/Application Support/ScreenStop/owner_encoding.npy
=== "Windows"
%LOCALAPPDATA%\ScreenStop\owner_encoding.npy
Face data is never uploaded to the dashboard. It stays on the local machine.
Local Config File
A local config file is written by the dashboard sync process and read by the daemon on each detection cycle.
=== "macOS"
~/Library/Application Support/ScreenStop/config.json
=== "Windows"
%LOCALAPPDATA%\ScreenStop\config.json
Warning
Do not edit this file manually. It will be overwritten by the next dashboard sync.
Dashboard URL
The dashboard URL is set at build time via the SCREENSTOP_DASHBOARD_URL environment variable. Stations connect automatically after installation — no endpoint configuration required.
Log Files
=== "macOS"
~/Library/Application Support/ScreenStop/screenstop.log
=== "Windows"
%LOCALAPPDATA%\ScreenStop\screenstop.log
Log verbosity is controlled by the LOG_LEVEL dashboard setting and applies without restarting the daemon.