An interactive terminal based todo.txt file editor
todd is an interactive console TODO-list manager with VI key bindings.
The file format conforms to todo.txt. This means you have full control over your data and can choose to store it locally or in the cloud (like Dropbox). You can use different applications to access your tasks on your desktop or mobile devices.
Thanks to the creator and contributors of todotxt-machine for providing the basis for this project.
View your tasks in a column formatted list with relative due dates
Switch context (only view tasks that you can work on)
Sort by due date or priority
Edit in plain text with tab completion or adjust priority and due
Due dates can be set with
weekday name (mo, tu, …)
offset (2d in two days, 3m in three moths, 1y in a year)
a fixed date (YYYY-MM-DD)
Supports Python 3.6 on Linux or macOS.
pip3 install todd
(Or pip install todd if Python 3 is the default for your system.)
Download or clone this repo and run the todd.py script.
git clone https://github.com/laktak/todd cd todd pip3 install -r requirements.txt ./todd.py
Command Line Options
todd Usage: todd [--config FILE] [TODOFILE] [DONEFILE] todd (-h | --help) todd --version todd --show-default-bindings Options: -c FILE --config=FILE Path to your todd configuraton file [default: ~/.toddrc] -h --help Show this screen. --version Show version. --show-default-bindings Show default keybindings in config parser format
You can tell todd to use the same todo.txt file whenever it starts up by adding a file entry to the ~/.toddrc file. If you want to archive done tasks, you can specify a done.txt file using an archive entry. You can also set you preferred colorscheme or even define new themes.
Here is a short example:
[settings] file = ~/todo.txt archive = ~/done.txt enable-word-wrap = True colorscheme = myawesometheme
Here is a config file with a complete colorscheme definition:
[settings] file = ~/todo.txt colorscheme = myawesometheme [colorscheme-myawesometheme] plain=h250 ...
You can add colorschemes by adding sections with names that start with colorscheme-. Then under the [settings] section you can say which colorscheme you want to use.
The format for a color definitions is:
See active key bindings with h or ? in todd.
You can customize any key binding by adding a setting to the [keys] section of your config file ~/.toddrc.
For a list of the default key bindings run:
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.