Skip to content


Browse files Browse the repository at this point in the history
Merge pull request #44 from ActivityWatch/doc/readme-update
Add install instructions to
  • Loading branch information
johan-bjareholt committed Apr 25, 2020
2 parents 620b52c + bc33438 commit fbec7ed
Showing 1 changed file with 16 additions and 1 deletion.
17 changes: 16 additions & 1 deletion
Expand Up @@ -5,7 +5,22 @@ Cross-platform window-Watcher for Linux (X11), macOS, Windows.

[![Build Status](](

### Note to macOS users
## How to install

To install the pre-built application, go to

To build your own packaged application, run `make package`

To install the latest git version directly from github without cloning, run
`pip install git+`

To install from a cloned version, cd into the directory and run
`poetry install` to install inside an virtualenv. 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.

## 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.
Expand Down

0 comments on commit fbec7ed

Please sign in to comment.