Track time spent on multiple projects, one repo at a time from the CLI
Time is saved in pandas-friendly csv files
- Libre Software (aka open-source)
- Quick to set up
- Own your data
- NO invasive tracking ever of keystrokes, browser activity, mouse-clicks, etc., as is done by multitudinous other timetracking apps
- Human-readable ASCII data stored in csv (comma-separated values) plaintext files:
- Ready for pandas, the Python Data Analysis Library for tabular data
- Editable using many editors, including vim and Notepad++
- Modify your data if you forget to log time
- Quickly see the current task being recorded
- Quickly see elapsed time spent on the current task
- No clicking and clicking and clicking on a GUI
- No required use of the internet or cloud-based services
- Data supported for each time interval includes:
- A required free-form descriptive message
- An optional
activityor type - Any number of tags
- Export data for import by external time-tracking viewers
The name used by this time tracker is determined by the USER environmental variable by default.
$ trk init
Initialized timetracker directory: /PROJDIR/.timetracker
$ trk start
Timetracker started now: Mon 09:00 AM: 2025-03-24 09:00:00
$ trk stop -m 'Accomplished the planned task'
Timer stopped at Mon 2025-03-24 12:00:00 PM
Elapsed H:M:S 0:03:00 appended to timetracker_timetracker_dvk.csv
$ trk report
Day Date Span Total Description
Sun 2025-03-24 03:00 03:00 Accomplished the planned task
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
Install with timetracker-csv pip:
$ pip install timetracker-csv
Or install from source:
$ git clone [email protected]:dvklopfenstein/timetracker.git
$ cd timetracker
$ pip install .
- 700+ stars Bartib
- 740+ stars timetrace
- 13k stars ActivityWatch
- 85 stars ti
- 44 stars tim
- 6 stars Jupyter timetracker uses aTimeLogger csv format
- https://atimelogger.pro/ csv files
- List of timetrackers in PyPi
- web-based time tracking application
- Wage Labor record:
- jupyter-timetracker - GUI too complex/too close to DB editing tools. No support for clients
- tim CLI only, no idle time detection but uses hledger as a backend!
- salary-timetracker CLI only, tracking bound to git repos, fixed hourly rate but hey it uses CSV files!
- ttrac CLI only, no idle time detection, no support for clients or tasks but uses JSON files!
- tickertock only with a StreamDeck, wants to use cloud service as backend but uses a hardware interface!
- mttt CLI only, no idle time detection but uses plain text files!
- tt-cli CLI only, no idle time detection, no support for clients
- timetracker CLI only, no idle time detection, no support for clients
- 1k stars hamster comes pretty close but seems outdated/abandoned and a little bit too complex
Copyright (C) 2025-present, DV Klopfenstein, PhD. All rights reserved