ttr - a very simple time tracker

As the name implies, this is a very simple time-tracking CLI. It can start and stop events, that are categorized into categories and tasks.

The idea is that categories contain multiple tasks, and each event is connected to a specific task. The event has a start time, and if it has been finished it has an end time.

Currently, management of categories and tasks needs to be done manually with the sqlite3 CLI. The same goes for retreiving any kind of statistics.

How to run

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
./ttr -h

Configuration

The configuration file should be placed in ~/.ttrrc, and follows the .env file format:

DB_PATH="/my/path/to/a/sqlite/file"

The only variable that can be configured as of now, is DB_PATH. ttr will use the DB at this path.

This can be overridden each time ttr is run with the -p parameter:

ttr -p /my/other/path init

The default value for DB_PATH is ~/.ttr.sqlite.

Roadmap

• Starting and stopping events
• Adding new categories and tasks
• Pausing events
• Viewing statistics
• PKGBUILD/publishing on AUR