Create quick and short daily summaries of your toggl entries per project per description.
You would need python version 3.6 or above. You can check your current version by running python3 -V
You will need to generate Toggl API token which can be found at the bottom of the page of your Toggl profile.
Install the dependencies then run the script. If --since is not provided, timetracker will only summarize entries for today.
$ pip install -r requirements.txt
$ python3 timetracker.py --since 2020-01-01 --token <toggl_token>
checkin 2020-01-01
- 3.64 hrs #project-1 Bugs
- 1.07 hrs #project-2 Features
- 0.50 hr #project-2 Pull RequestsYou can also set env variable TIMETRACKER_TOKEN to the token and you can skip
the token arg
export TIMETRACKER_TOKEN=<toggl_token>
python3 timetracker.py --since 2020-01-01
You can also set the timezone. The default value is Asia/Manila
python3 timetracker.py --since 2020-01-01 --timezone='Asia/Manila'
The script applies a .lower() to the the project name and places a # infront of the project. Project-1 will be converted to #project-1
You can automatically post your checkins to the #dailycheckin channel by configuring some Slack credentials. You will need a Slack app that has the chat:write user scope. We're using the Heartbeat app by default.
export SLACK_CLIENT_ID=<heartbeat_app_client_id>
export SLACK_CLIENT_SECRET=<heartbet_app_client_secret>
Run the local server to print the url for authorizing the app. Open this url on a browser where you're logged in to Slack. You should see the generated user token after clicking "Allow".
python3 slack_token.py
Use this generated user token as an arg or as an env variable:
python3 timetracker.py --slack-token <slack_user_token>
# or
export TIMETRACKER_SLACK_TOKEN=<slack_user_token>
python3 timetracker.py
The timetracker script should now prompt you to submit your checkins to #dailycheckin.
Setting up development
pre-commit install- Project format
- Add some logging
- Set up ci/cd