Desktop Timer
The Desktop Timer is the primary time tracking application for employees.
Features
- One-click timer — start/stop tracking with project + task
- Screenshot capture — periodic screenshots at configurable intervals
- Activity monitoring — keyboard/mouse activity percentage
- Idle detection — pauses tracking and prompts on idle
- System tray — background operation with tray icon
- Offline mode — tracks time offline, syncs when connected
- Multi-monitor — captures screenshots from all monitors
- Auto-start — optional launch on system startup
Timer Flow
1. Employee logs in
2. Selects organization, project, and task
3. Clicks "Start" → timer begins
4. Every 10 minutes:
- Screenshot captured
- Activity level calculated
- Time slot created and synced
5. Employee clicks "Stop" → time log finalized
Configuration
From API Server
Settings pushed from server configuration:
| Setting | Description |
|---|---|
| Screenshot interval | Minutes between captures |
| Random screenshot | Randomize timing |
| Track on sleep | Track during idle |
| Allow manual time | Permit manual entries |
| Allow screen capture | Enable screenshots |
Local Settings
| Setting | Default | Description |
|---|---|---|
| Auto-start | Off | Launch on OS boot |
| Minimize to tray | On | Minimize to system tray |
| Desktop notifications | On | Show tracking notifications |
| Monitor selection | All | Which monitors to capture |
Screenshots
Capture Process
- Timer triggers at configured interval
- Screenshot captured from selected monitors
- Thumbnail generated for quick preview
- Full image uploaded to configured storage
- Associated with current time slot
Storage
Screenshots follow the platform's file storage configuration (FILE_PROVIDER):
- Local filesystem
- AWS S3
- Wasabi
- DigitalOcean Spaces
- Cloudinary
Idle Detection
- System monitors keyboard/mouse input
- After configurable idle threshold → prompt appears
- Employee chooses:
- Keep — idle time counted
- Remove — idle period deleted
- Resume — tracking continues from current time
Related Pages
- Desktop Overview
- Time Tracking — feature details
- Activity Tracking — screenshots + activity