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.16.tar.gz (131.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

topydo-0.16-py3-none-any.whl (152.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: topydo-0.16.tar.gz
  • Upload date:
  • Size: 131.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.12

File hashes

Hashes for topydo-0.16.tar.gz
Algorithm Hash digest
SHA256 64a12a990ee39950f0a6e14a5c18e6b35c9e4e4f11cfa40c613d5feb4f086b75
MD5 4fda1305545edc17458770c3205a3cc8
BLAKE2b-256 116a8278ac5a59ec633322dcdff278bf74ce8c9d513370cf41d1ecfa5e0376d0

See more details on using hashes here.

File details

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

File metadata

  • Download URL: topydo-0.16-py3-none-any.whl
  • Upload date:
  • Size: 152.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.12

File hashes

Hashes for topydo-0.16-py3-none-any.whl
Algorithm Hash digest
SHA256 8d70eec6210f41a857d387d79cf9a8f157b9628ffc145ac6239e3ab0ced5a0bc
MD5 5625f9263d77e874e51df4393c601a20
BLAKE2b-256 fb5579c3aefc368dcf31a14964de2ebedd3af04cbf9584e6ac017a6cbc4a6a8f

See more details on using hashes here.

Supported by

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