Repository files navigation

topydo is a powerful todo list application using thetodo.txt format.

It has three user interfaces:

• Command Line Interface (CLI) - originally inspired by thetodo.txt CLIby Gina Trapani.
• Prompt mode - a convenience mode for the CLI. Launch withtopydo prompt.
• Column mode - a text based user interface (TUI) with customizable columns andvim-like bindings. Launch withtopydo columns.

Feature-wise, the todo.txt format is quite limited, but can be extended usingtags. topydo natively supports some of these tags to implement:

• Due andstart dates;
• Maintaindependencies between todo items;
• recurring todo items;

topydo also offers:

• Fine-grained control onsorting andgrouping items;
• Customizable output;
• Some conveniences when adding new items (e.g. adding creation date and userelative dates);
• Additional output formats to iCalendar, JSON and Graphviz Dot;
• Aliases for frequently used commands.
• Text based todo identifiers, which are more stable and convenient thanline-based todo identifiers.

Yet, topydo is fully todo.txt compliant. The text file can be processed byother todo.txt tools (but they may not interpret the tags properly).

The documentation onthe TiddlyWiki provides more information about thefeatures and how to use topydo.

Simply install with:

pip3 install topydo

If you wish to use column mode: install additional dependencies with:

pip3 install topydo[columns]

Similarly, for prompt mode you can install additional dependencies with:

pip3 install topydo[prompt]

CLI mode: