AW Watcher CLI

A CLI to track activities in activitywatch.

Getting Started

Installing

Install Activity Watch system wide to get the aw-client library, follow the docs

Place this scrip wherever you want, for instance ~/activitywatch/aw-watcher-cli

Add Aliases to your .bashrc or equivalent, for instance

alias work="python3 /home/mundo/activitywatch/aw-watcher-cli/add-activity.py work"

Add as many buckets as you want, for instance

alias homework="python3 /home/mundo/activitywatch/aw-watcher-cli/add-activity.py homework"

alias netflix="python3 /home/mundo/activitywatch/aw-watcher-cli/add-activity.py netflix"

Usage

If you did it my way, you already added a bucket in your alias, this way you reduce the change for a typo when logging your activity.

So all you need to do is

bucket -a "I am doing this now"

This will start a timer on your current terminal window, to end the activity just interrupt it (ctl + C)

There is a -p option to start/stop gnome-pomodoro

You can also ask for help

bucket -h

usage: add-activity.py [-h] [-a ACTIVITY] [-s START] [-e END] Bucket

Track activity on a given bucket in ActivityWatch

positional arguments:
  Bucket                Bucket where to track the activity

optional arguments:
  -h, --help            show this help message and exit
  -a ACTIVITY, --activity ACTIVITY
                        Activity description
  -s START, --start_time START
                        Set a start time
  -e END, --end_time END
                        Set an end time, used for setting arbitrary activities
  -p, --pomodoro        start/stop gnome-pomodoro
  -r, --report          Show activity report

Contributing

Branch it, PR me

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

• The activity Watch guys
• Hat tip to anyone whose code was used
• Inspiration
• etc