omnifocus-to-kanban's Introduction

omnifocus-to-kanban

What is this?

This is a tool that synchronises data from OmniFocus with a LeanKit or Trello board.

Why?

This allows you to visualise your Omnifocus data on a Kanban board or task board. I prefer this to manage my work in progress than using Omnifocus alone. Here's a blog I wrote with more info on my thinking.

How to install

Dependencies

This tool needs these libraries to function correctly:

requests (2.11.1)
trello (0.9.1)
docopt (0.6.2)
sqlalchemy

Run:

python setup.py install

to install them.

How to use

LeanKit

Configuration

Copy the leankit-config.yaml.example file as leankit-config.yaml. Edit the file as follows:

email: your Leankit email address
password: your Leankit password
account: your Leankit account name
board_id: your board ID
completed_lanes:
  - list of Leankit lane ID's that indicate which lanes contain completed work

If you don't know the lane ID's for your board, use:

./bin/leankit-lanes

Running

./bin/of-to-kb --leankit

Trello

Configuration

Copy the trello-config.yaml.example file as trello-config.yaml. Edit the file as follows:

app_key: your trello key
token: your trello token if you use a private board
board_id: your PK board id
default_list: the ID of the list in which you want the tool to add new cards into
completed_lists:
    - ID's of lists in which completed cards are found