calcurse

Manage calendar, appointments, and tasks

TLDR

Start calcurse on interactive mode

$ calcurse

Print the appointments and events for the current day and exit

$ calcurse --appointment

Remove all local calcurse items and import remote objects

$ calcurse-caldav --init=keep-remote

Remove all remote objects and push local calcurse items

$ calcurse-caldav --init=keep-local

Copy local objects to the CalDAV server and vice versa

$ calcurse-caldav --init=two-way

SYNOPSIS

calcurse [-c ] [-d ] [-f ] [-G ] [-n ] [-q] [-s] [-v] [-x]

-c
    Specify an alternate calendar file.

-d
    Specify an alternate directory to store data files.

-f
    Specify an alternate configuration file.

-G
    Set the weekday that separates two weeks (default: 1 = Monday).

-n
    Display the next days in the main window.

-q
    Start calcurse without loading the configuration file.

-s
    Suppress the loading of the calendar and todo files.

-v
    Display version information and exit.

-x
    When importing, export, or batch-import data, use the XML format instead of iCalendar.

DESCRIPTION

calcurse is a text-based calendar and scheduling application for the command line. It helps users manage appointments, tasks, and recurring events directly from the terminal. It offers a user-friendly interface using curses, allowing for efficient navigation and data entry.
calcurse stores its data in plain text files, making it easy to back up, synchronize, and customize. It supports features such as recurring appointments, alarms, and importing/exporting data in iCalendar (ics) format. Its lightweight nature and keyboard-centric interface make it a suitable choice for users who prefer command-line productivity tools. The application's interface is divided into three main panels for appointments, tasks, and a calendar view which helps you plan your day to day, week to week or month to month. This allows for easy usage of this program, even though it's in a terminal.

KEY BINDINGS

calcurse uses intuitive key bindings for navigation and editing. Arrow keys are used to navigate between appointments, tasks and days. 'a' adds a new appointment, 't' adds a new task, 'd' deletes an item, and 'g' jumps to a specific date. Pressing '?' will show all keybindings.

DATA STORAGE

By default, calcurse stores its data in the ~/.calcurse/ directory. This directory contains separate files for appointments, tasks, and configuration. Users can modify the directory location using the -d option.