tt

Command-line time tracker written in shell script

Why? How?

Usage

Start the activity

tt --start "working on this timer"

Starting 'working on this timer'

Finish the activity

tt --finish

Sun Mar 21 00:38:10 UTC 2021 | working on this timer | 11h 25m

Options

tt

tt - time tracker

Tracks activity time with a simple start/stop syntax. Logs to CSV.
Allows one activity active at a time, per session.

usage: tt                                       # show this help
usage: tt (--help or -h)                        # show this help
usage: tt --version                             # show tt current version
usage: tt (--start or -s) [activity name]       # start a new activity
usage: tt (--pause or -p)                       # pauses current activity
usage: tt (--done or -d or --finish or -f)      # stop and log activity
usage: tt (--abort or -a)                       # stop activity, no log
usage: tt --clear-logs                          # delete log of previous activities
usage: tt --activity-name                       # show activity for current session
usage: tt (--logs or -l)                        # show logs of previous activities

Installation

Download

curl https://raw.githubusercontent.com/strdr4605/tt/latest/tt.sh > $HOME/tt.sh

Source in your shell config file

# ZSH
echo "source $HOME/tt.sh" >>$HOME/.zshrc

# BASH
echo "source $HOME/tt.sh" >>$HOME/.bashrc

Development

1. Change tt.sh (use shellcheck)
2. source ./tt.sh
3. tt