Skip to main content

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

Project description

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:

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.


pip install 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

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for todotxt-machine, version 1.1.0
Filename, size File type Python version Upload date Hashes
Filename, size todotxt_machine-1.1.0-py2.7.egg (59.1 kB) File type Egg Python version 2.7 Upload date Hashes View
Filename, size todotxt_machine-1.1.0-py3.3.egg (61.6 kB) File type Egg Python version 3.3 Upload date Hashes View
Filename, size todotxt-machine-1.1.0.tar.gz (27.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page