Skip to main content

A simple icalendar-based todo manager.

Project description

CI status Codecov coverage report documentation version on pypi licence code style: black

Todoman is a simple, standards-based, cli todo (aka: task) manager. Todos are stored into icalendar files, which means you can sync them via CalDAV using, for example, vdirsyncer.

Todoman is now part of the pimutils project, and is hosted at GitHub.

Todoman should run fine on any Unix-like OS. It’s been tested on GNU/Linux, BSD, and macOS. We do not support windows, and very basic testing seems to indicate it does not work.

Feel free to join the IRC channel: #pimutils on


  • Listing, editing and creating todos.

  • Todos are read from individual ics files from the configured directory. This matches the vdir specification.

  • There’s support for the most common TODO features for now (summary, description, location, due date and priority).

  • Todoman should run on any major operating system (except Windows).

  • Unsupported fields may not be shown but are never deleted or altered.


For detailed usage, configuration and contributing documentation, please consult the latest version of the manual at readthedocs.


Todoman is licensed under the ISC licence. See LICENCE for details.

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

todoman-4.4.0.tar.gz (67.6 kB view hashes)

Uploaded Source

Built Distribution

todoman-4.4.0-py3-none-any.whl (29.8 kB view hashes)

Uploaded Python 3

Supported by

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