TimeTracker is an application loosely based on TimeKeeper, a Windows application used to track the time you spent on a task.
Being a Linux user and not willing to install Wine, I decided to hack my own version.
· Python 2.4
–version show program's version number and exit
-h, –help show this help message and exit
–config-file=CONFIG Configuration file to use
-nFILE, –new=FILE Start a new TimeTracker file
-t, –task Start a new task
-cCLIENT, –client=CLIENT Task client
-aACTIVITY, –activity=ACTIVITY Task activity
-rREFERENCE, –reference=REFERENCE Task reference
-mCOMMENT, –comment=COMMENT Task comment
-l, –list Print the task list
-s, –stop Stop the current task
-f, –force Force starting a new task when one is already running or update the stop time of an already stopped task
-v, –verbose Show the parameters values
–summary=SUMMARY_TYPE Report of time. Valid options are: day: total working hours per day
–fix Recalculate the elapsed time of every task (new on 0.5)
–time Time of start/stop (will use current time if not defined). Can be "yyyy/mm/dd hh:mm:ss", "yyyy/mm/dd hh:mm", "hh:mm:ss" or even "hh:mm". On stop, the date is ignored.
How to use it
If you never used TimeKeeper, besides being lucky, you won't see use for most of those fields. But everything starts with a data file, specified in the --new option. To start a task in this file, use the --task option, specifying --client, --activity and --reference. You only have to specify those three values once; every call later will use the last used values for those fields. You can also specify a --comment for the task. Once you finish the task, stop the counter with the --stop option.
TimeTracker saves the TimeTracker file, client, activity and reference on ~/.timetracker.ini. These data are used on further calls, so you don't have to worry about them. If you need to see these values, use the --verbose option.