Features

• 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

• Search/filter

• 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)

Installation

Supports Python 3.6 on Linux or macOS.

pip3 install todd

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

Config File

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

Color Schemes

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:

name=[foreground],[background]

Foreground and background colors are follow the 256 color formats defined by urwid. You can see all the colors defined here.

Key Bindings

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:

todd --show-default-bindings