forked from zzamboni/things2thl
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME
executable file
·104 lines (83 loc) · 4.7 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
Things2THL 0.8.5
http://zzamboni.org/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 <[email protected]>
INSTALLATION:
------------
You need Things 1.1.1 or later, since things2thl requires Applescript
support.
Then install things2thl by running:
$ sudo gem install zzamboni-things2thl --source http://gems.github.com/
Note: things2thl need the rb-appscript
(http://appscript.sourceforge.net/rb-appscript/) and hpricot
(http://wiki.github.com/why/hpricot) . If you don't have them already,
they will be automatically installed by gem.
If you have a version of THL prior to 0.9.3.22beta, please use
things2thl 0.8.4, since there were some changes in the names of the
classes used internally by THL.
USAGE:
-----
Usage: things2thl <mode of operation> [options]
Modes of operation (required):
-L, --projects-as-lists Convert projects in Things to lists in THL
-T, --projects-as-tasks Convert projects in Things to tasks in THL
-B, --projects-areas-as-tasks Convert both projects and areas in Things
to lists in THL. This implies that
projects are not nested inside areas.
-I, --inbox Transfer only Inbox tasks.
Options:
--[no-]areas Transfer areas from Things (default: yes)
--areas-as-tags Transfer areas as tags in THL.
--areas-as-contexts Transfer areas as contexts in THL.
--[no-]time-tags Consider tags of the form Xmin/Xsec/Xhr as
time estimates, set them in THL
accordingly (default: no).
--[no-]context-tags [REGEX] Regular expression to identify tags that
should be interpreted as contexts.
(default: ^@).
Use with no- to disable this feature.
--sync Only transfer new items (default: no)
--top-level-folder FOLDER 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-top-level FOLDER The named folder will be created to
contain all projects when
--projects-as-lists is used (otherwise
they will be 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.
--areas-top-level FOLDER The named folder will be created to
contain all areas.
-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.
Twice: do not print stats at the end.
-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:
---------------------------
- Handling delegation ("People" feature in Things)
Not sure how to transfer this to THL. Ideas are welcome.
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.
- One-time tasks in the Things "Scheduled" focus are transferred, but
repeating tasks are not. The Things Applescript interface does not
provide access to repeating tasks.
- The format of time estimate tags is fixed for the moment. May add
customization if I get any requests for it.