Skip to main content

Modern TUI calendar and task manager

Project description


Modern TUI calendar and task manager with customizable interface. Manages your events and tasks, displays birthdays from your abook, and can import events and tasks from calcurse and taskwarrior.

See documentation for more information.



  • Vim keys
  • View tasks and events from .ics files synced with clouds
  • Operation with fewest key presses possible
  • Todo list with subtasks, deadlines, and timers
  • Birthdays of your abook contacts
  • Import of events and tasks from calcurse and taskwarrior
  • Icons according to the name ✈ ⛷ ⛱
  • Private events and tasks •••••
  • Plain text database in your folder for cloud sync
  • Customizable colors, icons, and other features
  • Resize and mobile friendly
  • Current weather ⛅
  • Support for Persian calendar


Linux and Mac OS

pip install calcure


  1. Install Windows Terminal app from the app store
  2. Install python 3.x also from the app store (if you just type python in the Windows Terminal app it will offer you to install)
  3. Install the program and libraries by typing in the Windows Terminal pip install windows-curses calcure
  4. Now you can finally run it by typing in the Windows Terminal python -m calcure

Upgrade to the most recent version

pip install --upgrade calcure


  • python 3.7 and higher
  • holidays, jdatetime, and ics python libraries.


Run calcure in your terminal. You may need to restart your terminal after the install.

Syncing with cloud calendars

This page in documentation shows examples how to sync and display in read-only mode events and tasks from Nextcloud, Google, and other calendars.

User arguments

Various user arguments can be added started in special mods add tasks and events etc.

Key bindings

List of all key bindings can be accessed in the wiki and via ? key in the program.


Example of config.ini file and explanations of all settings are available in the documentation. On the first run, program will create a config.ini file where you can edit parameters, colors, and icons at ~/.config/calcure/config.ini.


Typical problems and solutions are described in documentation. If you faced a new problem, don't hesitate to open an issue.

Contribution, translations, donations

Full information about contribution is available in the documentation.

If you'd like to support the development, consider donations.

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

calcure-2.8.3.tar.gz (41.7 kB view hashes)

Uploaded source

Built Distribution

calcure-2.8.3-py3-none-any.whl (48.7 kB view hashes)

Uploaded py3

Supported by

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