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