Skip to main content

A simple CalDav-based todo manager.

Project description

Travis CI build status Codecov coverage report documentation version on pypi licence Say Thanks!

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.


  • 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) for now.
  • 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.

Filename, size & hash SHA256 hash help File type Python version Upload date
todoman-3.4.1-py3-none-any.whl (27.3 kB) Copy SHA256 hash SHA256 Wheel py3 Sep 28, 2018
todoman-3.4.1.tar.gz (59.4 kB) Copy SHA256 hash SHA256 Source None Sep 28, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page