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](


View your todos in a list with helpful syntax highlighting:


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


Filter contexts and projects:


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




Python 2.7.5 or Python 3.3.2 with readline support. todotxt-machine outputs raw
[terminal control
sequences]( to draw it's
interface and does not rely on modules like
[curses]( or

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

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

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

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.0.0
Filename, size File type Python version Upload date Hashes
Filename, size todotxt_machine-1.0.0-py2.7.egg (68.1 kB) File type Egg Python version 2.7 Upload date Hashes View
Filename, size todotxt-machine-1.0.0.tar.gz (25.5 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