My recipe for customizing a todo.txt environment for Getting Things Done.
Given the following text in the file ~/Dropbox/todo/todo.txt:
Get an oil change @errands +CarMaintenance
Get a Haircut @errands +Grooming
Check the car battery water level @home +CarMaintenance
... running the tdtcleanup script will convert that file to this:
# CarMaintenance
#
Get an oil change @errands +CarMaintenance
Check the car battery water level @home +CarMaintenance
# Grooming
#
Get a Haircut @errands +Grooming
# _None
#
Now todo.txt can be treated as a comprehensive Projects file. Tasks are organized by Project, and arbitrary text related to projects can be added as comments.
A "#" comment block starting with a comment consisting of a single word is a Project Header, defining the default project for following tasks. The final _None project is special - it collects tasks that are added using various todo.txt applications.
On subsequent runs, tdtcleanup will do the following:
The tdtlist script lists the tasks in todo.txt, by context.
It has been moved to todo.txt-base.
The _project script supports working with a single project, or group of projects. It opens an edit session with just the specified project section from the todo.txt file, and replaces that section after the session is complete.
If all of the lines are deleted from the edit session, no changes are made to the original todo.txt file. If just the header line is kept, all other lines are deleted from the original.
Run project with the "-l" option to get a current list of projects.
A bash completion script is available that responds to tab completion with an appropriate project list.
tdtbackup is a utility script for making rotating backups of the todo.txt file.
It has been moved to todo.txt-base.
Always add an '@' context to tasks, to put them on the proper GTD list, and to identify them to tdtcleanup.
Either add '+' project name to individual tasks, or physically move them to the appropriate Project Section.
Add comments, as necessary, to fully document each Project.
For the Weekly Review:
I've found that running "for proj in `project -l`; do project -x $proj; done
" is a mind-clearing way to accomplish this.
Filter on '@' to limit your task lists to just tasks. I use a '\~' as a special context flag (e.g. '@\~errands') for tasks that cannot be performed yet due to an uncompleted previous step. If you pick up this convention, you may want to filter out '@~' from your lists as well.
Avoid the 'archive' operation. This typically will remove duplicate lines in todo.txt. This can wreak havoc on formatting, eliminating white space and empty comment lines in the file.
I've used the classic todo.txt CLI with success. As mentioned previously, avoid the archive operation.
I've come to prefer ToPydo, for its support of threshold dates and recurrence. Note that, for versions prior to 0.14, ToPydo needs a small change to avoid eliminating blank lines. Make sure to use the '-a' option to disable auto-archive on task completion (or set the config "archive_filename" to no content). My ~/.topydo:
[add]
auto_creation_date = 0
[topydo]
filename = ~/Dropbox/todo/todo.txt
archive_filename = ~/Dropbox/todo/done.txt
auto_delete_whitespace = 0
SimpleTask works well on Android. Make a "Current Tasks" filter with the "List" tab consisting of a checked "Invert Filter" box, plus check "-" and all contexts you want to eliminate (e.g. "someday").
For SimpleTask, I also add this LUA filter, to eliminated commented-out tasks:
function onFilter(task, fields, extensions)
c = string.sub(task, 1, 1);
if c == "#" then
return false;
end
return true;
end
Run 'tdtlist -l' for a printable todo list, for offline use.
Of course, a primary way of interacting with the todo list is by editing the todo.txt file directly.
The Deb package:
sudo apt-get update
sudo dpkg -i tdtgtd*.deb
sudo apt-get -f install
pip install:
pip install todo.txt-gtd
$ tdtcleanup -h
usage: tdtcleanup [-h] [-f FILE]
Clean up the todo.txt file in a GTD fashion
optional arguments:
-h, --help show this help message and exit
-f FILE, --file FILE the todo.txt file location (defaults to
~/Dropbox/todo/todo.txt)
$ project -h
usage: project [-h] [-f FILE] [-l] [-x] [TERM [TERM ...]]
Work with one or more GTD projects in todo.txt
positional arguments:
TERM search terms to filter the project(s) to use. Projects
matching ANY of the terms will be used.
optional arguments:
-h, --help show this help message and exit
-f FILE, --file FILE the todo.txt file location (defaults to
~/Dropbox/todo/todo.txt)
-l, --list just list the projects in the current todo.txt file
-x, --exact require an exact match of project to TERM
Edit one or more isolated projects in a todo.txt file (todo.txt projects are
denoted by a a leading "+"). If the entire project is deleted during the edit
session, the original project is preserved in todo.txt. If just the Project
Header line is kept, then the project is deleted in the original. The default
text editor, set by 'update-alternatives', is used. This can be overridden by
setting the 'EDITOR' environment variable.