A Toggl formatter for Timetrap
timetrap-toggl allows you to submit your timetrap timesheets to Toggl.
timetrap-toggl's initial development was sponsored by dscout. Many thanks to them!
# Reference one of your toggl project task aliases within an entry's note:
$ timetrap in working on timetrap-toggl @code
$ timetrap out
# display the entries you wish to submit using the toggl formatter:
$ timetrap display --start 'last monday' --end 'last friday' --format toggl$ gem install timetrap_toggl
$ echo "require 'timetrap_toggl'" > ./path/to/formatters/toggl.rb# ~/.timetrap.yml
---
...
toggl:
api_token: "YOUR_API_TOKEN"
workspace: "My workspace"The gem will find all the projects in the given workspace, and match them with the tags you add to your tasks. Here's a correspondence of examples of Toggl project names, and the corresponding tags you should use:
ProjectName:@projectname(matching is case-insensitive)Marketing & Communication:@marketing-communication(special characters and spaces are replaced with dashes)
timetrap-toggl depends upon the timetrap gem
When installing timetrap-toggl, timetrap is installed for you as a runtime dependency.
- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request
- dblandin for creating timetrap-harvest, which was the basis for this one