todotxt-machine 1.1.0

An interactive terminal based todo.txt file editor with an interface similar to mutt

todotxt-machine is an interactive terminal based todo.txt file editor with an interface similar to mutt. It follows the todo.txt format and stores todo items in plain text.

Screenshots

View your todos in a list with helpful syntax highlighting:

Sort in ascending or descending order, or keep things unsorted:

Filter contexts and projects:

Search for the todos you want to edit:

Search with fuzzy matching:

And some quotes for when you have nothing left to do:

Requirements

Python 2.7 or Python 3.3 with readline support on Linux or Mac OS X. todotxt-machine outputs raw terminal control sequences to draw its interface and does not rely on modules like curses or urwid.

Installation

pip install todotxt-machine

Command Line Options

usage: todotxt-machine.py [-h] [-f FILE] [--readline-editing-mode {emacs,vi}]

Interactive terminal interface for todo.txt files.

optional arguments:
  -h, --help            show this help message and exit
  -f FILE, --file FILE  path to your todo.txt file
                        default:~/Dropbox/todo/todo.txt
  --readline-editing-mode {emacs,vi}
                        set readline editing-mode

Key Bindings

General

?            - display this help message
q, ctrl-c    - quit

Movement

j, down      - move selection down
k, up        - move selection up
g, page up   - move selection to the top item
G, page down - move selection to the bottom item

Filtering & Sorting

p            - select the next project
P            - select the previous project
c            - select the next context
C            - select the previous context
s            - switch sorting method

Searching

/            - start search
ctrl-l       - clear search

While Searching

enter        - end search
ctrl-c       - cancel search

Manipulating Todo Items

x            - complete / un-complete selected todo item
n            - add a new todo to the end of the list
o            - add a todo after the selected todo
O            - add a todo before the selected todo
enter, A, e  - edit the selected todo
D            - delete the selected todo

While Editing a Todo

ctrl-c       - cancel editing a todo
tab          - tab complete @contexts and +Projects

Planned Features

• User defined color themes

• Manual reordering of todo items