Awesome ActivityWatch :star2: :fire:

A collections of awesome links to resources relating to ActivityWatch, the free and open-source automated time-tracker.

Please star :star: and share this repo! :loudspeaker:

This list is just getting started. Do you see anything missing? Make a pull request! :pencil2:

Official links :link:

Website
GitHub
Forum
Twitter
Discord
LinkedIn
r/ActivityWatch (mostly inactive), subreddit for ActivityWatch

Applications

The main ActivityWatch application and alternative implementations:

ActivityWatch (releases) - The official distribution, includes:
- aw-qt (tray application)
- aw-server & aw-server-rust (storage and API)
- aw-watcher-window (window tracking)
- aw-watcher-afk (idle detection)
- aw-watcher-input (keyboard/mouse usage)
- aw-sync (data syncing)
- aw-notify (notifications)
aw-tauri (WIP), experimental/alternative distribution of ActivityWatch using Tauri
Workflow, basic screentime application using GTK
Codewatch, desktop client for ActivityWatch focused on software development and productivity.
yet-another-UI-for-AW, a native UI for ActivityWatch with Japanese localization (announcement forum post)
timetrace, a macOS dashboard that merges ActivityWatch window data with iPhone/iPad Screen Time (via aw-import-screentime), sorts time by project and value, and exposes it to AI agents through a CLI and MCP server

Documentation :books:

Server Implementations :computer:

ActivityWatch has a modular architecture that includes a server component for storing and analyzing the collected data.

aw-server, an official server implementation written in Python
aw-server-rust, an official server implementation written in Rust for improved performance

Client Libraries

The ActivityWatch ecosystem provides client libraries to help developers interact with the ActivityWatch server API and create custom watchers, integrations, extensions, or applications. Here are the official client libraries:

aw-client, a client library written in Python
aw-client-js, a client library written in JavaScript/TypeScript
aw-client-rust, a client library written in Rust

Desktop Widgets :desktop_computer:

activitywatch-plasmoid, a KDE Plasma widget for ActivityWatch
activitywatch-status-gnome-shell, GNOME Shell extension that shows the total time spent today (source)

Watchers :watch:

ActivityWatch comes with two watchers enabled by default:

aw-watcher-afk - Watches for mouse & keyboard activity to detect if the user is active
aw-watcher-window - Watches the active window and its metadata

Window Watchers :desktop_computer:

aw-watcher-window - The official window watcher for Windows, macOS, and Linux (X11)
aw-watcher-window-wayland - Window watcher for Wayland by @johan-bjareholt
awatcher - A compiled watcher for X11 and Wayland by @2e3s
aw-watcher-enhanced - Enhanced window watcher with OCR screen capture, LLM-powered context extraction (via Ollama), smart idle detection, and remote desktop support by @kepptic

Browser Watchers :globe_with_meridians:

aw-watcher-web - Official browser extension for Chrome, Edge, and Firefox

Editor Watchers :pencil2:

aw-watcher-vim - Vim extension by @johan-bjareholt and @ahnlabb
aw-watcher-vscode - Visual Studio Code extension by @Otto-AA
activity-watch-mode - Emacs mode by @pauldub
aw-watcher-jetbrains - For all JetBrains IDEs by @OlivierMary (JetBrains Marketplace)
ActivityWatchVS - Visual Studio extension by @LaggAt
aw-idea - JetBrains IDE extension by @pascalwhoop (WIP)
aw-watcher-sublime - Sublime Text 3 by @kostasdizas
aw-watcher-atom - Atom by @NicoWeio
AwWatcherNetBeans82 - NetBeans 8.2 by @pytlus93
aw-watcher-obsidian - Obsidian.md extension by @LordGrimmauld
aw-watcher-zed - Zed extension by @sachk

Media Watchers :musical_note:

aw-watcher-spotify - Tracks currently playing Spotify tracks (Beta)
aw-watcher-chromecast - For Chromecast devices (WIP)
aw-watcher-openvr - For VR applications (WIP)
aw-watcher-mpv-sender - Tracks currently playing mpv videos (WIP)
aw-watcher-media-player - Tracks system-wide media playback
aw-watcher-lastfm - Tracks Last.fm scrobbles (supports most streaming services)

Other Watchers :gear:

aw-watcher-input - Tracks keyboard/mouse usage statistics
aw-watcher-table - Monitors height-adjustable desk position by @Alwinator
aw-watcher-tmux - Monitors tmux sessions by @akohlbecker
aw-watcher-ask - Periodically asks user questions (WIP)
aw-watcher-utilization - System resource monitoring by @Alwinator
aw-watcher-anki - Tracks Anki flashcard review time
aw-watcher-steam - Tracks Steam gaming sessions
aw-watcher-toggl - Imports time entries from Toggl
aw-watcher-netstatus - Network connectivity monitoring by @sameersismail
aw-watcher-buttons - Arduino-based hardware button tracking (WIP)
aw-watcher-screenshot - Periodic screenshot capture with perceptual hash filtering and optional S3 upload
aw-watcher-claude - Tracks active Claude Code sessions per project (reads only session metadata, never prompts) by @CoKeFish
aw-watcher-win-vdesktop - Periodic tracker of currently used virtual desktop's name on Windows 10/11.
aw-watcher-ms-presence - Tracker of current Microsoft 365 presence as reported by local Microsoft Teams application.
aw-workspace-watcher-win - Tracks Windows virtual desktops with work/personal contexts and an AFK-aware dashboard by @masawik

We also maintain a list of watchers in the documentation.

Want to create your own watcher? Check out the writing watchers guide in the documentation.

Have you written a watcher? Submit a PR to have it included here!

Importers :inbox_tray:

Tools for migrating historical time tracking data from other tools into ActivityWatch:

aw-import-toggl - Import Toggl Track time entries from CSV export into ActivityWatch
aw-import-rescuetime - Import RescueTime activity data from CSV export into ActivityWatch
aw-import-manictime - Import ManicTime data directly from its SQLite database into ActivityWatch
aw-import-clockify - Import Clockify time entries via API into ActivityWatch
aw-import-harvest - Import Harvest time entries via API into ActivityWatch
aw-import-screentime - Import macOS Screen Time data into ActivityWatch (official)

Sync

aw-sync, the official sync-with-folder/bring-your-own-sync solution for ActivityWatch
aw-sync-suite, a centralized sync solution backed by Prometheus and visualized with Grafana, by @phrp720
activitywatch-exporter, CLI tool that uploads the ActivityWatch data from the aw-server API to InfluxDB on a daily basis

AI/LLM Integrations 🤖

activitywatch-mcp-server - A Model Context Protocol (MCP) server that connects to ActivityWatch, allowing LLMs like Claude to interact with your time tracking data

Videos :tv:

ActivityWatch - Application time tracking done well (2023-2-3)
ActivityWatch: Save Time With Helpful Telemetry by @BrodieRobertson (2021-6-13)
ActivityWatch Development Visualization 2014-2020 (with Gource) by @ErikBjare (2020-12-20)

Custom dashboards :bar_chart:

Metabase dashboard by @SqrtMinusTwo: https://twitter.com/ActivityWatchIt/status/1522126015082151936
Grafana + PrometheusDB + InfluxDB dashboard by @KShivendu: https://twitter.com/KShivendu_/status/1697483679495557228

Donations :moneybag:

Support the development of ActivityWatch by making a donation. Your contribution helps maintain and improve the software, ensuring its continued development.

GitHub Sponsors, support the project through GitHub Sponsors
Open Collective, donate and view transparent expenses and funding on Open Collective
Support individual contributors
- Erik Bjäreholt's GitHub Sponsors or Patreon
- Johan Bjäreholt's GitHub Sponsors
For more, see the Donate page on the website

Thank you for supporting ActivityWatch and helping it stay afloat financially as free and open-source software! :heart:

ActivityWatch/awesome-activitywatch

Measured star growth

About

README.md