Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ActivityWatch/activitywatch/llms.txt

Use this file to discover all available pages before exploring further.

ActivityWatch is a free, open-source, privacy-first time tracker that runs entirely on your machine. It automatically records your active application, window title, browser tab, and AFK (away-from-keyboard) status — giving you a complete picture of how you spend your time without sending any data to external servers.

Get Started

Download ActivityWatch and start tracking your time in minutes

Installation

Install from a release package or build from source on any platform

Dashboard & Reports

Explore your activity data with timelines, summaries, and category breakdowns

Watchers

Discover all available trackers for apps, browsers, editors, and more

How ActivityWatch works

ActivityWatch consists of a local server, a set of watchers that collect data, and a web UI for exploring your activity. All data is stored on your machine.
1

Install ActivityWatch

Download the latest release for your platform (Windows, macOS, or Linux) and run the installer. ActivityWatch starts a local server on port 5600.
2

Watchers collect your activity

Built-in watchers automatically record the active window and application, AFK/idle status, and — with the browser extension — the active browser tab and URL.
3

Explore your data

Open the web dashboard at http://localhost:5600 to see activity timelines, summaries, and category breakdowns for any time range.
4

Extend and automate

Use the REST API or Python client library to build custom watchers, export data, or integrate ActivityWatch with other tools.

Key features

Privacy-first

All data lives on your machine. No cloud sync, no accounts required, no data leaves your device.

Cross-platform

Works on Windows, macOS, Linux, and Android. One consistent interface everywhere.

Extensible watchers

Track any activity type — editors, terminals, browsers, meetings — via community or custom watchers.

Powerful query engine

Filter, merge, and transform your event data with the built-in query language.

REST API

Full REST API for programmatic access to all your activity data.

Open source (MPL-2.0)

Inspect, modify, and contribute to the source code on GitHub.
ActivityWatch is 100% free and open source. If you find it useful, consider donating to support development.

Build docs developers (and LLMs) love