Skip to main content

A powerful todo.txt application for the console

Project description

topydo - a powerful todo.txt application

Build Status codecov.io Codacy Badge PyPI version

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

It has three user interfaces:

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

png

Features

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

  • Due and start dates;
  • Maintain dependencies between todo items;
  • recurring todo items;

topydo also offers:

  • Fine-grained control on sorting and grouping items;
  • Customizable output;
  • Some conveniences when adding new items (e.g. adding creation date and use relative 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 than line-based todo identifiers.

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

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

Installation

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]

Demo

CLI mode:

gif

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

topydo-0.15.tar.gz (129.3 kB view details)

Uploaded Source

Built Distribution

topydo-0.15-py3-none-any.whl (149.5 kB view details)

Uploaded Python 3

File details

Details for the file topydo-0.15.tar.gz.

File metadata

  • Download URL: topydo-0.15.tar.gz
  • Upload date:
  • Size: 129.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for topydo-0.15.tar.gz
Algorithm Hash digest
SHA256 4e466c33934b4ffe48ee3c65347799276adc47b3010fb617bf8b8693473f8799
MD5 d89c4a66df8290376fb1e07aae0c7acb
BLAKE2b-256 ca8848f2fcd7a0c7c62676eb1df8ea2ac2fcaa388614beaf63077472005d44ef

See more details on using hashes here.

File details

Details for the file topydo-0.15-py3-none-any.whl.

File metadata

  • Download URL: topydo-0.15-py3-none-any.whl
  • Upload date:
  • Size: 149.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for topydo-0.15-py3-none-any.whl
Algorithm Hash digest
SHA256 8896d0db712e881fd3780424c18d6492d7fc860a6b04744fc7c8c9e3f1f01f02
MD5 e5c2fbca891a83888f42a7dcf83ef7fe
BLAKE2b-256 b1881b46a97a61d4d0dfc7ec911131308d907981803b27d5eb4aa16bcc2998e9

See more details on using hashes here.

Supported by

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