This script will help you calculate your working hours by recording boot, shutdown and time spent during lunch. I know, it should probably be named lunchtime or something but timetrckr sounds cooler (and more ambitious too :) ) Wouldn't have been possible without the Sleepwatcher daemon.
-
Clone this project:
git clone git@github.com:spygi/timetrckr.git -
Install Sleepwatcher:
brew install sleepwatcher(tested with version 2.2) -
Set up launchd:
cp de.bernhard-baehr.sleepwatcher-20compatibility-localuser.plist timetrckr.plist ~/Library/LaunchAgents/Change the WorkingDirectory in both of the .plists to point to the location where you cloned the repo.
Done. Next time you boot, the script will start recording time in time.csv, show Growl-like notifications and write down the summary of the previous day in summary.txt.
For every new day that starts the script writes the number of hours you worked in the previous one in summary.txt. You can produce the report anew also manually by running ./timetrckr.sh -r all to get the summary for all days recorded (except the current one), or -r one for the last day only. The outcome will be written in standard output (you can always redirect it to a file) and the overall hours will be shown with a Growl-like notification (notifications don't work from inside tmux).
Have a look at timetrckr.conf for which parameters you can customize. If you want to use a different .conf file, specify it in the ProgramArguments of the two .plists with -f: ./timetrckr.sh -w -f <path_to_conf_file> (and similar for -s).
The excellent Sleepwatcher daemon catches sleep and wake events (could be extended to catch also login events but me no speak no C). Timetrckr.plist catches login events. Shutdown events are caught by the script itself (on the beginning of a new day). This is done by grepping the logs because shutdowns are not propagated properly to launchd daemons (see Issue#5).
The script creates a time.csv file which contains the boot, shutdown and lunch times and a summary.txt which contains the date and the number of hours worked that day.
The script assumes a consistent working routine takes place. This working routine starts by booting your computer and ends by shutting it down (no usage for personal purposes). In between you take a break for lunch, during which your computer is on sleep mode. The rest of the time is spent on work related activities (work on the computer, meetings etc) which count as work time.
Well, basically because I don't need something more sophisticated (or didn't figure a simple enough solution to detect if you are in a meeting or just taking a break). The script will work well enough for computer based, desk jobs with standard working hours (or should I say standard lunch hours?).
This won't be recorded. You can still temper with the output of the file..it is just text after all. Just make sure you keep the same format (separator and time formats) and you should be fine. Note that if you change the time.csv file you should re-generate the summary using the -r argument and overwrite the summary.txt.
Sure, just configure the output to be in a Dropbox synced folder.
Yes, see How does it work as well. Instead of the timetrck.plist you could create an Application in Automator with a Run Shell script action which contains ./timetrckr.sh, save it and make it a Login Item in System Preferences.
Make sure the Sleepwatcher (or timetrckr) daemons are loaded eg: launchctl list | grep sleepwatcher. If they are not running, open Console.app and start them manually: launchctl load ~/Library/LaunchAgents/timetrckr.plist and sleepwatcher.plist(launchctl does not work inside tmux) Do you see any weird output in Console?
Make sure the script is executable: chmod 755 path_to_timetrckr.sh
Open the Console.app, maybe it helps you. Otherwise have a look at the code, it's pretty simple.