tt /

Filename Size Date modified Message
29 B
18.1 KB
1.4 KB
20.9 KB


tt is a simple Time Tracking tool you can use to track your hours worked. It searches the filesystem for a file called 'times.txt' in which it stores the time tracking data.


tt [options] [message]

  -h, --help            show this help message and exit
  -f FILE, --file=FILE  Read times from FILE.
  -C DIR, --directory=DIR
                        Use DIR and don't ascend searching for 'times.txt'. If
                        it is not found in DIR it is considered empty.
  -e, --end             End session.
  -c, --current         Display current session.
  -l, --list            List overview.
  -d, --days            List per day overview.
  -w, --weeks           List per week overview.
  -m, --months          List per month overview.
  -r, --repeat          Repeat last non-empty non-end message (may start a new
  -H CALENDAR, --holidays=CALENDAR
                        Use dates of the ical file CALENDAR as holidays (can
                        be url).
                        Set quota in h/workday for a given date range.
  -q, --quota           Show difference to current work quota.
  -j FILE, --join=FILE  Join other time tracking files into this one.


  • Python >= 2.6
  • icalendar (when a holiday calendar is used)
  • httplib2 (when the holiday calendar is an URL)