Time Tracking With Watson

Published by Stephan on

Today I would like to introduce a command-line tool that I have been using for some months for time tracking. Until Ubuntu 18.04 I always used the hamster applet, which was great. But under 20.04 this applet does not work anymore. So I looked around for alternatives and ended up with Watson – a command-line tool. Time tracking with Watson is different from the Hamster applet, but let’s have a look at the installation first.


Watson is a Python program and is best installed using the Python package manager pip:

To make it easier to use, we will also install the Bash auto-complete:

For the auto-completion to work, you have to restart the terminal.

How to use Watson

There are several commands to help you keep track of time, display summaries, or manage individual projects. The most important ones I will introduce now:

Tracking the time of a project

In the background, a “frame” or time segment is created for the project including the two keywords. With keywords, you can e.g. record the time for subprojects/subtasks.


you can finish the time tracking for the project.

Other helpful commands

Sometimes it happens that I forget to execute “watson stop”. With

you can edit the last frame:

watson edit

To restart the last project, enter:

To see a summary of my projects I can use the following commands:

You can get a list of all commands with


Watson is a really easy to use command-line tool. I like the time tracking with Watson, although I also found the hamster applet very handy. Some community projects around Watson improve the work with it, e.g. a GUI and other nice little things. One feature that is still missing in my opinion is the possibility to add notes to a frame. There is a Pull Request for this, but it is not merged in the project yet.

Which tool do you use for time tracking?

Categories: HowTo



I'm a teacher and IT system administrator in an international school. I love open source software and I used it over a decade in my private and work life. My passion is to solve problems with open source software!


Leave a Reply

Your email address will not be published.