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’s community frequently asks about privacy, data storage, platform support, and how to extend tracking. For more support, visit forum.activitywatch.net or join Discord.
Yes. ActivityWatch is completely free and open source under the MPL-2.0 license. There are no paid tiers or premium features.
No. All activity data is stored locally in a SQLite database on your machine. The server only binds to localhost by default, so no data ever leaves your device.
Windows, macOS, Linux, and Android. iOS is not currently supported.
Check that aw-watcher-window is listed in the Buckets page at http://localhost:5600. On macOS, grant Accessibility permission under System Settings → Privacy & Security → Accessibility. On Linux X11, ensure xdotool and xprop are installed.
Another process is occupying port 5600. Open ~/.config/activitywatch/aw-server/aw-server.toml (Linux/macOS) or %APPDATA%\activitywatch\aw-server\aw-server.toml (Windows) and change port to a free port such as 5601.
  • Windows: %APPDATA%\activitywatch\aw-server\
  • macOS: ~/Library/Application Support/activitywatch/aw-server/
  • Linux: ~/.local/share/activitywatch/aw-server/
Stop ActivityWatch, then copy the database directory above. You can also export individual buckets as JSON from the dashboard’s Raw Data view.
Make sure ActivityWatch is running (look for the system tray icon) and at least one watcher is active. A new installation may show an empty dashboard for the first few minutes while the first events are recorded.
Yes. Install the aw-watcher-web browser extension for Chrome or Firefox, available from activitywatch.net.
  • Windows: Use Add/Remove Programs, then delete %APPDATA%\activitywatch.
  • macOS: Drag ActivityWatch from Applications to Trash, then delete ~/Library/Application Support/activitywatch.
  • Linux: Delete the extracted directory and ~/.config/activitywatch.
An alternative server implementation written in Rust, planned to become the default. It exposes the same REST API and is compatible with all existing clients and watchers.
Yes, experimentally. Use aw-sync (bundled with aw-server-rust) combined with a file-sync tool such as Syncthing or Dropbox. See the Sync guide.
File an issue on GitHub using the provided issue template. Include your OS, ActivityWatch version, and steps to reproduce.

Build docs developers (and LLMs) love