Things2THL
http://zzamboni.github.com/things2thl/

Conversion program to transfer data from Things
(http://culturedcode.com/things/ ) to The Hit List
(http://www.potionfactory.com/thehitlist/ ).

Written by Diego Zamboni <diego@zzamboni.org>

INSTALL:
--------

You need Things 1.1.1 or later, since things2thl requires Applescript
support.

You need to install rb-appscript from
http://appscript.sourceforge.net/rb-appscript/install.html

Then install things2thl by running:
     $ sudo gem install zzamboni-things2thl --source http://gems.github.com/


USAGE:
-----

Usage: things2thl [options]

Options:
        --projects-as-lists          Convert projects in Things to lists in THL (default)
        --projects-as-tasks          Convert projects in Things to tasks in THL
        --[no-]areas                 Transfer areas from Things (default: yes)
    -C, --context-tags-regex REGEX   Regular expression to identify tags that should be interpreted as contexts.
                                       (default: ^@)
        --top-level-folder FOLDER    If specified, do the import inside the named folders, instead of the top level
                                      (Inbox, etc. will also be created there instead of their corresponding places)
        --projects-folder FOLDER     If specified, the named folder will be created to contain all projects when
                                       --projects-as-lists is used (otherwise they will be put in the top folders group).
                                       If --projects-as-tasks is used, a 'Projects' list is always created, but this option
                                       can be used to specify its name.
    -c, --completed                  Transfer also completed/canceled tasks and projects (default: no)
        --[no-]archive-completed     If transferring completed/canceled tasks, also mark them as archived (default: yes)
    -q, --quiet                      Do not print items as they are processed
    -h, --help                       Shows this help message
    -v, --version                    Shows version

Options you should seldom need:
        --things THINGSAPP           Location of the Things application (default: /Applications/Things.app)
        --thl THLAPP                 Location of the The Hit List application (default: /Applications/The Hit List.app)


Functionality still missing:
---------------------------

- Handle rich-text notes (with attachments, links, etc.) properly

  Plan: not sure yet. Need to investigate how notes are stored in
  THL (Things uses an XML format)

- Handling delegation ("People" feature in Things)

  Not sure how to transfer this to THL. Ideas are welcome.

- Handle "time estimate" tags.

  Plan: Allow specifying certain Things tags (e.g. I use "10min",
  "30min", "60min") that should be used to set the time estimate for
  the task in THL.

Known issues:
-------------

- Cancellation/completion dates are not transferred, because THL
  handles those attributes as read-only. So if you choose to transfer
  completed/canceled tasks, they will all appear in your "completed
  today" view.

- Tasks in the Things "Scheduled" focus are transferred, but the
  scheduling itself is not transferred, because this information is
  not accessible through AS from either Things not THL.