/services-to-omnifocus

A collection of scripts to pipe new tasks from various services into OmniFocus

Primary LanguageRuby

services-to-omnifocus

This is a collection of scripts that I wrote to poll several services I use on a daily basis for tasks that require my attention and pipe them into OmniFocus.

Some service integrations have built-in intelligence to sync changes back and forth, but it only goes so far.

Supported services

As of this writing, scripts to query the APIs of Autotask, Zendesk, Highrise, GitHub Issues, and Trello are included. See the notes in the header of the respective plugins for implementation notes.

Setting up

The scripts expect your site-specific URLs, API keys, and passwords as environment variables. A sample environment is included as env.sample. This typically goes into your ~/.zshrc or ~/.bashrc.

The API dependencies and such are managed with bundler. After cloning the repository, install those dependencies with bundle install in the repository directory.

Running

I run the master script (services-to-omnifocus.rb) from a Keyboard Maestro macro. It will run all of the plugins contained in the plugins/ subdirectory. If you don't care for a particular service, move its plugin into the plugins_disabled/ directory.

You can also run it through launchd, on login, etc.

Customizing

This is currently highly bent towards my personal needs. I'm sharing it in case anyone else finds it useful. If you have something to share back, please open a pull request.