Manually adding events



I know activitywatch is supposed to be an automatic activity tracker, but sometimes I need to add a manual entry. Is there any tool which integrates ActivityWatch and allows for manual entry or would this need to be implemented via a watcher (either via cli or GUI)? I’m willing to create a new watcher, but i would like to know if it would be a good fit for this project.



There does not currently exist a GUI/CLI for adding events manually to ActivityWatch buckets, but it’s certainly possible!

I’m interested in adding the ability to manually add events as it could be a good fit for many types of data (and because I log a lot of stuff manually myself). But for most types of manual entries it might be best to write a task-specific client GUI/CLI.

Here are a few options:

  • If you want to create a GUI, you could look into writing a small HTML/JS app that provides a form and sends the data to the server (we’re working on which would make this pretty easy)
  • If you want to create a CLI you should be able to do that pretty easily using the aw-client Python library.
  • If you just want to add one or two events and don’t mind writing JSON manually you can use the API browser that’s bundled with aw-server (see