Skip to content
This repository has been archived by the owner on Feb 7, 2019. It is now read-only.

Terminal watcher for the free open-source tracking tool ActivityWatch

License

Notifications You must be signed in to change notification settings

Otto-AA/aw-watcher-terminal

Repository files navigation

No Maintenance Intended

aw-watcher-terminal [Unmaintained]

Extension to ActivityWatch which allows you to track the commands you've written and time spent in terminals.

Build Status


Features

Tracking commands and metadata

Automatically track following data for every command execution:

  • the executed command
  • path of the shell
  • shell name
  • exit code of the command
  • execution time
  • session id (automatically created)

Tracking activity time

For simpler analysis on how long you've worked in the terminal (and in which directories and paths) this data is stored in a separate bucket. Following data is tracked there:

  • shell name
  • path
  • session id

Restoring specific terminal sessions (Not implemented yet)

With the data stored it is theoretically possible to write all commands executed in a specific terminal session into a file. This feature is not yet implemented.


Installation

Prerequisites

You need to have ActivityWatch installed.

Install aw-watcher-terminal

git clone https://github.com/otto-aa/aw-watcher-terminal.git
cd aw-watcher-terminal
make build

Install the appropriate watcher for your shell

If your preferred shell is missing, feel free to file an issue or create the shell watcher on your own (see docs).

Start aw-watcher-terminal

# If the aw-server is not started yet (e.g. by aw-qt), then start it in a separate terminal
aw-server
# Start the terminal watcher
aw-watcher-terminal

Currently, you can pass it the flags --testing for using the test server and --verbose for more detailed logging

Note: If you want it to autostart with aw-qt, take a look at this this issue

Open a new terminal and start executing commands

echo "Finished installation"

About

Terminal watcher for the free open-source tracking tool ActivityWatch

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published