/topydo

A powerful todo list application for the console, using the todo.txt format.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

topydo

Build Status codecov.io Join the chat at https://gitter.im/bram85/topydo Flattr this git repo

topydo is a todo list application using the todo.txt format. It is heavily inspired by the todo.txt CLI by Gina Trapani. This tool is actually a merge between the todo.txt CLI and a number of extensions that I wrote on top of the CLI. These extensions are:

  • Set due and start dates;
  • Custom sorting;
  • Dealing with tags;
  • Maintain dependencies between todo items;
  • Allow todo items to recur;
  • Some conveniences when adding new items (e.g. adding creation date and use relative dates);

The documentation on topydo.org provides more information about the features and how to use topydo.

Install

Simply install with:

pip install topydo

Dependencies

  • arrow : Used to turn dates into a human readable version.

Optional dependencies:

  • icalendar : To print your todo.txt file as an iCalendar file (not supported for PyPy3).
  • prompt-toolkit : For topydo's prompt mode, which offers a shell-like interface with auto-completion.
  • arrow : Used to turn dates into a human readable version.
  • urwid : For topydo's columns mode, a TUI with columns for your todo items.
  • backports.shutil_get_terminal_size : Used to determine your terminal window size. This function was added to the standard library in Python 3.3 and so is only required for PyPy3.
  • mock : Used for testing. This was added to the standard library in Python 3.3.

Demo

gif