snapshot of https://github.com/ActivityWatch/aw-watcher-window.git (master, 2026-09-16; blobs > 131072B omitted)

README.md

@@ -0,0 +1,31 @@
+aw-watcher-window
+=================
+
+Cross-platform window-Watcher for Linux (X11), macOS, Windows.
+
+[![Build Status](https://travis-ci.org/ActivityWatch/aw-watcher-window.svg?branch=master)](https://travis-ci.org/ActivityWatch/aw-watcher-window)
+
+## How to install
+
+To install the pre-built application, go to https://activitywatch.net/downloads/
+
+To build your own packaged application, run `make package`
+
+To install the latest git version directly from github without cloning, run
+`pip install git+https://github.com/ActivityWatch/aw-watcher-window.git`
+
+To install from a cloned version, cd into the directory and run
+`poetry install` to install inside an virtualenv. You can run the binary via `aw-watcher-window`.
+
+If you want to install it system-wide it can be installed with `pip install .`, but that has the issue
+that it might not get the exact version of the dependencies due to not reading the poetry.lock file.
+
+## Usage
+
+In order for this watcher to be available in the UI, you'll need to have a Away From Computer (afk) watcher running alongside it.
+
+### Note to macOS users
+
+To log current window title the terminal needs access to macOS accessibility API.
+This can be enabled in `System Preferences > Security & Privacy > Accessibility`, then add the Terminal to this list. If this is not enabled the watcher can only log current application, and not window title.
+