Skip to content

benhughes/OmniToggl

Repository files navigation

OmniToggl

A omnifocus plugin to seamlessly start and stop Toggl timers from inside OmniFocus

What it does

Example

When you highlight a task in OmniFocus and then kick off this automation, a timer will be started with:

  • Description as the name of the task
  • Tags copied over from OmniFocus
  • Project used from the task the project is contained in within OmniFocus. The script will create a new Project if the project doesn't exist in Toggl.

Requriements

  • Omnifocus Pro with Automation activated
  • For iOS you need the Omnifocus version > 3.11.2.
  • A Toggl Account Sign up here

How to install on Mac

  1. Download latest release from here
  2. Unzip and open the file called OmniToggl.omnifocusjs this should open the file in OmniFocus
  3. Choose if you would like to install on Mac (to only use locally) or "OmniFocus in iCloud Drive" (to make it available across platforms (including iPhone and iPad) Omnifocus Dialog
  4. Choose Automation > Configure in the menu
  5. Choose OmniToggl in menu and click Reveal in Finder Omnifocus Dialog
  6. In finder right click on OmniToggl.omnifocusjs and select Show Package Contents Omnifocus Dialog
  7. Open Resources/common.js in your favourite text editor Omnifocus Dialog
  8. Replace 'REPLACE_ME' with you toggl API Token that can be found here
  9. Quit and Restart OmniFocus
  10. You should now be all set up and can start a timer by clicking on a task and choosing Automation > OmniToggle > Start Timer from the menu.

Note: if anyone knows of a way to store data other then having to edit a file as described then please let me know as it seems it should be easier then this but the documentation is not great.