tt /

Filename Size Date modified Message
29 B
17.7 KB
1.3 KB
19.3 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.


  • Python >= 2.6
  • icalendar (when a holiday calendar is used)
  • httplib2 (when the holiday calendar is an URL)
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.