Timetracker-csv
Track time spent on multiple projects, one repo at a time from the CLI
Time is saved in pandas-friendly CSV files
Quickstart
The name
used by this time tracker is determined
by the USER
environmental variable by default.
In this example, the username is "bez."
#----------------------------------------------------
# 1) Initialize a timetracker project
$ cd /home/bez/meetinghouse
$ trk init
Initialized timetracker directory: /home/bez/meetinghouse/.timetracker
#----------------------------------------------------
# 2) Start the timer
$ trk start
Timetracker started now: Mon 09:00 AM: 2025-03-24 09:00:00
#----------------------------------------------------
# 3) Stop the timer
$ trk stop -m 'Received instructions'
Timer stopped at Mon 2025-03-24 12:00:00 PM
Elapsed H:M:S 0:03:00 appended to timetracker_meetinghouse_bez.csv
#----------------------------------------------------
# 4a) Report my time units for this project
$ trk report
Day Date Span Total Description
Sun 2025-03-24 03:00 03:00 Received instructions
#- - - - - - - - - - - - - - - - - - - - - - - - - -
# 4b) You can also get the total hours that you spent on a project:
$ trk hours
0:03:00 H:M:S or 3.000 hours
Installation
Install with timetracker-csv pip:
$ pip install timetracker-csv
Or install from source:
$ git clone git@github.com:dvklopfenstein/timetracker.git
$ cd timetracker
$ pip install .
Copyright (C) 2025, DV Klopfenstein, PhD. All rights reserved