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.

Screenshots

View your todos in a list with helpful syntax highlighting:

https://raw.github.com/AnthonyDiGirolamo/todotxt-machine/master/screenshots/screenshot1.png

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

https://raw.github.com/AnthonyDiGirolamo/todotxt-machine/master/screenshots/screenshot3.png

Filter contexts and projects:

https://raw.github.com/AnthonyDiGirolamo/todotxt-machine/master/screenshots/screenshot2.png

Search for the todos you want to edit:

https://raw.github.com/AnthonyDiGirolamo/todotxt-machine/master/screenshots/screenshot4.png

Search with fuzzy matching:

https://raw.github.com/AnthonyDiGirolamo/todotxt-machine/master/screenshots/screenshot5.png

Tab completion of contexts and projects:

https://raw.github.com/AnthonyDiGirolamo/todotxt-machine/master/screenshots/screenshot6.png

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

https://raw.github.com/AnthonyDiGirolamo/todotxt-machine/master/screenshots/screenshot_quote1.png https://raw.github.com/AnthonyDiGirolamo/todotxt-machine/master/screenshots/screenshot_quote2.png

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

Using pip

pip install todotxt-machine

Manually

git clone https://github.com/AnthonyDiGirolamo/todotxt-machine.git
cd todotxt-machine
./todotxt-machine.py

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
w            - save current todo file

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

Updates

See the log on github

Project details


Download files

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

Source Distribution

todotxt-machine-1.1.8.tar.gz (28.1 kB view hashes)

Uploaded Source

Built Distributions

todotxt_machine-1.1.8-py3.4.egg (61.9 kB view hashes)

Uploaded Source

todotxt_machine-1.1.8-py2.7.egg (60.3 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page