Skip to main content

Modern TUI calendar and task manager

Project description

Calcure

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.

screenshot

Features

  • 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

Installation

Linux and Mac OS

There are several ways to install:

pipx install calcure - the up-to-date version from PyPi. You may need to install pipx first.

yay -S calcure - AUR package is available. Upvote to support the project!

calcure is also available as NixOS package.

Windows

  1. Install Windows Terminal app from the Microsoft Store.
  2. Install Python 3.x also from the Microsoft 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

pipx upgrade calcure

Dependencies

  • python 3.10 and higher (usually already installed)
  • holidays, jdatetime, and icalendar python libraries (should be installed automatically with the calcure).
  • windows-curses on Windows

Usage

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.

Settings

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.

Troubleshooting

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

Contribution

Full information about contribution is available in the documentation.

Support

I am not a professional developer and work on open-source projects in my free time. If you'd like to support the development, consider donations via buymeacoffee or cryptocurrencies:

  • BTC bc1qpkzmutdqfxkce34skt09vll97s5smpa0r2tyzj
  • ETH 0x6f1Ce9cA181458Fc153a5f7cBF88044736C3b00C
  • BNB 0x40f22c372758E35C905458cAF8BB17f51ac133d1
  • LTC ltc1qtu33qyv2xlzxda5mmrmk943zpksq8q75tuh85p
  • XMR 4AHRhpNYUZcPVN78rbUWAzBuvMKQdpwStS5L3kjunnBMWWW2pjYBko1RUF6nQVpgQPdfAkM3jrEWrWKDHz1h4Ucd4gFCZ9j

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

Uploaded Source

Built Distribution

calcure-3.2.1-py3-none-any.whl (62.0 kB view details)

Uploaded Python 3

File details

Details for the file calcure-3.2.1.tar.gz.

File metadata

  • Download URL: calcure-3.2.1.tar.gz
  • Upload date:
  • Size: 53.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.2

File hashes

Hashes for calcure-3.2.1.tar.gz
Algorithm Hash digest
SHA256 4a7df1107ab17b8db6e268c5d1127daf1ef022c905c912823769734402b4d10b
MD5 b0b488199bedc896b4a1f56c0a4b78a8
BLAKE2b-256 0ca781436c1da4067fec87c8bd84ec0db4c01f77f7c456a736476e92273fdf84

See more details on using hashes here.

File details

Details for the file calcure-3.2.1-py3-none-any.whl.

File metadata

  • Download URL: calcure-3.2.1-py3-none-any.whl
  • Upload date:
  • Size: 62.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.2

File hashes

Hashes for calcure-3.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 6c7104e94356d93c386899d5aa3dcf50cf97d1be9fadaf5cb48a89deb6762850
MD5 7ef659d17da45a2ba1aa1c71e90ea80f
BLAKE2b-256 3f337ef08aae26908e812b7a883d7d7722f702c59cd581f1c4f436f436666919

See more details on using hashes here.

Supported by

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