Dashboard Guide
The ScreenStop Dashboard is the central management console for all protected workstations. From here, IT administrators can monitor events, push configuration changes, and control detection behavior across the fleet.
Accessing the Dashboard
The dashboard is a web application hosted on your organization's server.
Default credentials (change on first login):
| Role | Username | Password |
|---|---|---|
| Admin | admin |
admin |
| Viewer | user |
screenstop |
Station List
The main view shows all registered stations:
- Status indicator — green when online, grey when last seen >5 min ago
- Last seen timestamp
- Device ID — unique identifier per machine
- Detection events count
Stations register automatically the first time ScreenStop runs and contacts the dashboard.
Event Feed
Each station reports events in real time:
| Event Type | Trigger |
|---|---|
phone_detected |
Phone pointed at screen |
unauthorized_face |
Unrecognized person detected |
shoulder_surfing |
Multiple faces detected |
screen_locked |
Screen locked by daemon |
unattended |
No face detected, screen locked |
Events include a timestamp, device ID, and (where applicable) a captured image thumbnail.
Pushing Configuration
Changes made in the Dashboard are pushed to stations within ~5 seconds (next sync cycle).
To change a setting:
- Go to Stations > select a station (or select all)
- Click Configure
- Adjust the desired settings
- Click Save — changes sync automatically
Note
No restart is required on the endpoint. The daemon reads the updated config on its next detection cycle.
Log Streaming
When debug_mode is enabled for a station, logs stream live to the dashboard.
- Select a station
- Toggle Debug Mode on
- Open the Logs tab to see live output
Use LOG_LEVEL = DEBUG for verbose output. Remember to set it back to INFO when done.
Alerts & Notifications
(Coming in a future release)
Email and webhook notifications for detection events are planned. For now, all events are visible in the dashboard event feed.