https://github.com/activitywatch/aw-watcher-window

Cross-platform window watcher (for use with ActivityWatch)
https://github.com/activitywatch/aw-watcher-window

active-window activitywatch activitywatch-watcher quantified-self

Last synced: about 19 hours ago
JSON representation

Cross-platform window watcher (for use with ActivityWatch)

• Host: GitHub
• URL: https://github.com/activitywatch/aw-watcher-window
• Owner: ActivityWatch
• License: mpl-2.0
• Created: 2016-08-19T14:03:34.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2024-10-17T17:16:48.000Z (2 months ago)
• Last Synced: 2024-12-21T04:03:22.827Z (1 day ago)
• Topics: active-window, activitywatch, activitywatch-watcher, quantified-self
• Language: Python
• Homepage:
• Size: 366 KB
• Stars: 91
• Watchers: 10
• Forks: 55
• Open Issues: 27
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
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.