Watson utilities

These are just some quick scripts to use with the wonderful Watson time tracker.

watson-sh

An interactive shell for Watson. It simply dispatches to watson itself, but keeps the context (current project, date span, …) Use it with rlwrap (see watson-sh --help) for improved experience (command history, completion, …)

Optional dependency:

• rlwrap

watson-notify

A cron script to alert you when you forgot to start Watson. Displays a notification when:

• you are working on the same project for a long period,
• you are not working on a project.

The purpose is to remind you to start tracking your time, or to check if you have forgotten to change the project (and remind you to take a break).

Uses notify-send (from libnotify) to send the alert.

Put the script in a cron task. For instance:

*/5 *  *   *   *     $HOME/bin/watson-notify

You can redefined the alert parameters in the $WATSON_DIR/alert file which will be sourced if present. Run watson-notify -c to display the current configuration.

watson-notify -c > $HOME/.config/watson/alert

TIP: to use a random message, put one message by line in a file (e.g. $HOME/.config/watson/messages) and use

QUESTION_MESSAGE="$(shuf -n 1 $CONFIG_DIR/messages)"

in the $WATSON_DIR/alert file. If you use a command-line task management tool, like Taskwarrior, it's easy to display the next task to do in the notification. For taskwarrior, I use the following QUESTION_MESSAGE:

QUESTION_MESSAGE="$(shuf -n 1 $CONFIG_DIR/messages)\n\n<b>TODO:</b>\n$(task rc.verbose=nothing now)"

with the custom now report defined as:

report.now.description=To do now
report.now.columns=id,description.desc
report.now.filter=status:pending and limit:3
report.now.sort=urgency-

to display the next 3 tasks (description and ID).

The notification can be suspended for a short period of time using the --snooze option.

Dependency:

• notify-send: (libnotify-bin on Debian)

watson-periodic-report

Print Watson reports by time periods.

This is just a little wrapper around watson report. For instance, to print a monthly report for the last 5 months:

watson-periodic-report 5 months

and to print a weekly report for the last 10 weeks

watson-periodic-report 10 weeks

watson-status

An I3 bar status displaying the current project (using conky).

Save in e.g. ~/.config/i3/watson-status and add

{"full_text": "\${texeci 5 ~/.config/i3/watson-status}"}

to your conky configuration file.

Another tip that don't deserve a file here: I bind ctrl+alt+delete to a small script that stop watson, snooze the notification and lock the screen. When unlocked, the notification is activated.

#!/bin/bash
watson stop
watson-notify -s 10 hours
mpc pause
i3lock -f -n -c 000000
watson-notify -a

on-modify-watson.py

A Taskwarrior hook to start a watson task according to a taskwarrior one.

When starting a task in taskwarrior, the hook starts a corresponding project in watson. The project and keywords of the taskwarrior task are used in watson. When stopping a task in taskwarrior, the hook stops the watson project.

To install, copy in $HOME/.task/hooks/on-modify-watson.py and make executable.

watson-convert

A tool to convert watson frames to other formats.

Usage:

watson-convert <format>

The formats currently supported are:

• icalendar
• ledger

These two formats can be used to create alternative reports. For instance:

• to display a calendar of the work done in June 2016:

  watson-convert ical | ical2html -d -m -l -z Europe/Paris 20160601 P4W > tasks.html

• to display the relative time spent on dev tasks by projects for this month:

  watson-convert ledger | ledger -f - balance --begin "this month" --percent tag dev

This script suppose that the watson "project" field has the form:

[task]@project[.subject]

For instance Write unit tests@MySuperApp.NewFeature (this is the format used by the taskwarrior hook).

Licence

These scripts are released under the Do What The Fuck You Want To Public License.