skip to navigation
skip to content

todotxt-machine 1.1.7

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

Latest Version: 2.2.2

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.


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:

Tab completion of contexts and projects:

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


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.


Using pip

pip install todotxt-machine


git clone
cd todotxt-machine

Command Line Options

usage: [-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
  --readline-editing-mode {emacs,vi}
                        set readline editing-mode

Key Bindings


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


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


/            - 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


See the log on github

File Type Py Version Uploaded on Size
todotxt-machine-1.1.7.tar.gz (md5) Source 2014-07-26 27KB
todotxt_machine-1.1.7-py2.7.egg (md5) Python Egg 2.7 2014-07-26 58KB
todotxt_machine-1.1.7-py3.4.egg (md5) Python Egg 3.4 2014-07-26 60KB