# Todoman

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.

## Features

- 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).

- Runs on any Unix-like OS. It’s been tested on GNU/Linux, BSD and macOS.

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

## Contributing

See Contributing for details on contributing.

## Caveats

Support for the `percent-completed` attribute is incomplete. Todoman can only mark todos as completed (100%), and will not reflect nor allow editing for values for `percent > 0 ^ percent < 100`.

# Table of Contents

- Installing
  - Distribution packages
  - Manual installation
  - bash autocompletion (optional)
  - zsh autocompletion (optional)
  - fish autocompletion (optional)
  - Requirements
  - Notes for Packagers
- Configuring
  - Configuration File
  - Sample configuration
  - Color and displayname
  - Timezone
- Usage
  - Synchronization
  - Interactive shell
  - Integrations
  - Sorting
- Man page
  - todoman
  - Description
  - Usage
  - Synchronization
  - Interactive shell
  - Integrations
  - Sorting
  - Configuring
  - Configuration File
  - Sample configuration
  - Color and displayname
  - Timezone
  - Caveats
  - Contributing
  - LICENCE
- Contributing
  - Hacking
  - Patch review checklist
  - Packaging
- Changelog
  - v4.7.0
  - v4.6.0
  - v4.5.0
  - v4.4.0
  - v4.3.2
  - v4.3.1
  - v4.3.0
  - v4.2.0
  - v4.1.0
  - v4.0.1
  - v4.0.0
  - v3.9.0
  - v3.8.0
  - v3.7.0
  - v3.6.0
  - v3.5.0
  - v3.4.1
  - v3.4.0
  - v3.3.0
  - v3.2.4
  - v3.2.3
  - v3.2.2
  - v3.2.1
  - v3.2.0
  - v3.1.0
  - v3.0.1
  - v3.0.0
  - v2.1.0
  - v2.0.2
  - v2.0.1
  - v2.0.0
- Licence

# Indices and tables

- Index

- Module Index

- Search Page