better-timetagger-cli 0.1.0

A command line tool for TimeTagger. This is a more feature-rich and ergonomic fork of the original timetagger-cli, providing better user experience and additional features.

(Better) TimeTagger CLI

Track your time with TimeTagger from the command line.

This is a more feature-rich and ergonomic fork of the original timetagger-cli by Almar Klein, providing additional features and improved ergonomics.

What's new?

This project does everything that the original timetracker-cli did, but it adds some great features and usibility improvements - batteries included!
See how they compare:

	better-timetagger-cli	timetagger-cli
Start Tasks	✅ adjustable time and more...	✅
Stop Tasks	✅ adjustable time and more...	✅
Resume Tasks	✅ adjustable time simplified UX for record selection and more...	✅
Display Status	✅ includes breakdown per tag	✅
Show Records	✅ filter by tags optional summary or summary-only live monitoring and more...	✅
Diagnose & Fix Record Errors	✅	✅
Export to CSV	✅	❌
Import from CSV	✅ includes dry-run mode to validate CSV files	❌
Colored Output	✅	❌
Natural language support	✅ use phrases like '5 min ago', 'last Friday' or 'May 12'	❌
Configurable date/time format	✅	❌
Command aliases	✅ t in and t out, are an alias for t start and t stop	❌
Command shortcuts	✅ Abbreviate commands like t out to t o	❌

Installation

The TimeTagger CLI requires Python 3.10 or higher. Install with your favorite Python package manager, e.g.:

pipx install better-time-tagger

You can now use the CLI as either timetagger or simply t.

t --version
#  (Better) TimeTagger CLI, version X.X.X

Migrating from timetagger_cli

This project is a drop-in replacement for the original timetagger-cli package. You should first remove the original package from your system, then install better-timetagger-cli.

pipx uninstall timetagger-cli
pipx install better-timetagger-cli

Then run the setup command, to automatically migrate your existing timetagger configuration.

t setup
#  Migrating legacy configuration to new format...
#  TimeTagger config file: /path/to/config.toml

Configuration

Before using the CLI for the first time, you must configure the URL of your TimeTagger server, along with your API key. To update the configuration, simply run:

t setup

This will open the configuration file in your default editor. The first time you run this command, a default configuration file will be created automatically. Also, if an exsting configuration file from the original timetagger-cli pacage is found, it is migrated automatically.

Contribute

To report bugs or request features, please file a github issue on this repository.

Pull-Requests are welcome too. Please always file a github issue first.