跳到主要内容

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