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 wiki for more information.
Features
- Vim keys
- 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
pip install --upgrade calcure
Windows
- Install
Windows Terminal
app from the app store - Install
python 3.x
also from the app store (if you just typepython
in the Windows Terminal app it will offer you to install) - Install the program and libraries libraries by typing in the Windows Terminal
pip install windows-curses calcure
- 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
Dependencies
- python 3
holidays
andjdatetime
python libraries. Install bypip install holidays jdatetime
.
Usage
Run calcure
in your terminal. You may need to restart your terminal after the install.
User arguments
Calcure supports automations and can be started in special mods using various user arguments. Please refer to this wiki page for the list of options.
Key bindings
List of all key bindings can be accessed in the wiki and via ?
key in the program.
Settings
On the first run, program will create a configuration file at ~/.config/calcure/config.ini
.
You can edit parameters, colors, and icons in the config.ini
file.
An example of the config.ini file is here.
Explanations of all settings are in the wiki.
Troubleshooting
- If your terminal shows empty squares instead of icons, probably it does not support unicode. In this case, in config set:
use_unicode_icons = No
. - Weather widget slows down launch of the program and requires internet. If that is a problem, switch weather off in config:
show_weather = No
. - If weather is incorrect, set your city in config
weather_city = Tokyo
. By default, this setting is empty and program tries to detect your city automatically from your ip. - If after install the program does not run by just running
calcure
, try to restart your terminal, it may need to recheck the binaries. - AUR package is autdated, please use
pip install calcure
for installation.
Roadmap
- Translations (currently done: English, French, Russian, Italian, and Brazilian Portuguese)
- Support for .ics files in read only mode
- Improvement of the daily view (several days on the page)
- Support for .ics files in read and write mode
Contribution, translations, donations
If you wish to contribute to the development or translations, feel free to open issues or propose PRs. Particularly, you are welcome to contribute to translations (create a copy of en.py
in translations folder in your language), packaging for repositories, and syncing with popular calendar services. For big changes, please open an issue to discuss first.
If you'd like to support the development, consider donations.
For more information about contribution, see wiki pages.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.