A command line utility to keep track of your working hours.
TimeKeeper automatically tracks public holidays.
As such, it requires the holidays
package.
Install e.g., via pip
as follows.
pip3 install holidays
When you start working, simply type
tkp start
and when you finish, use
tkp stop
This will create a new entry in you work time database.
Starting when you are already working is a no-op and will instead print your current work time since the last start.
Similarly, stopping a work session when you are not working (did not issue tkp start
) is a no-op as well.
To view your work time over longer durations, use the view
command.
To view the current week's statistics use
tkp view
If you want to include more weeks, use index slicing
# current and previous week
tkp view -1:
# previous week, current week and next week
tkp view -1:1
We use plain-text files to track work times because it allows simple synchronization across multiple devices via git + automatic conflict resolution.