Timetracker-csv

PyPI - Version DOI GitHub License

Track time spent on multiple projects, one repo at a time from the CLI

Time is saved in pandas-friendly CSV files

timetracker

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