Skip to main content

Activity Tracking

Activity tracking captures screenshots, application usage, and website visits to provide productivity insights.

Features​

FeatureSourcePrivacy Controls
ScreenshotsDesktop TimerConfigurable frequency, blur option
App TrackingDesktop TimerWhich apps are used
URL TrackingBrowser ExtensionWebsites visited
Activity LevelDesktop TimerKeyboard/mouse activity %

Screenshots​

How It Works​

  1. Desktop Timer captures a screenshot at configured intervals
  2. Screenshot is uploaded to the server (or local storage)
  3. Thumbnail is generated for quick preview
  4. Screenshots are associated with time slots

Configuration​

SettingDefaultDescription
screenshotFrequency10 minMinutes between captures
randomScreenshotfalseRandomize timing within interval
isScreenshotEnabledtrueEnable/disable screenshots
allowScreenshotCapturetrueAllow capture at org level

Screenshot Storage​

Screenshots can be stored in:

StorageConfigurationUse Case
Local filesystemFILE_PROVIDER=LOCALSelf-hosted, single server
AWS S3FILE_PROVIDER=S3Cloud, scalable storage
WasabiFILE_PROVIDER=WASABIS3-compatible, cost-effective
CloudinaryFILE_PROVIDER=CLOUDINARYImage optimization
DigitalOcean SpacesFILE_PROVIDER=DIGITALOCEANSimple cloud storage

Privacy Controls​

  • Blur screenshots — Managers see activity but not content
  • Delete screenshots — Employees can delete individual screenshots
  • Disable tracking — Employees can pause screenshot capture
  • View own screenshots — Employees can review their own captures

Application Tracking​

Records which applications are used during tracked time:

DataDescription
titleApplication window title
descriptionApplication name
dateTimestamp
durationTime spent (seconds)
typeAPP or URL

Activity Levels​

Activity is measured through keyboard and mouse events within each 10-minute time slot:

Calculation​

activity_percentage = (keyboard_events + mouse_events) / max_expected_events × 100

Reporting​

Activity reports show:

  • Daily activity timeline
  • Average activity per project
  • Activity distribution across time slots
  • Top applications used
  • Most visited websites