Calcurse - text-based organizer
calcurse [-h|-v] [-N] [-an] [-t[num]] [-c<file> | -D<dir>]
[-i<file>] [-x[format]] [-d <date>|<num>]
[-s[date]] [-r[range]] [-S <regex>] [--status]
Calcurse is a text-based calendar and scheduling application. It helps
keeping track of events, appointments and everyday tasks. A
configurable notification system reminds user of upcoming deadlines,
and the curses based interface can be customized to suit user needs.
All of the commands are documented within an online help system.
The following options are supported:
Print the appointments and events for the current day and exit.
Note: the calendar from which to read the appointments can be
specified using the ’-c’ flag.
-c <file>, --calendar <file>
Specify the calendar file to use. The default calendar is
’~/.calcurse/apts’ (see section FILES below). This option is
incompatible with -D.
-d <date|num>, --day <date|num>
Print the appointments and events for the given date or for the
given number of upcoming days, depending on the argument format.
Two possible formats are supported:
· a date (see below for possible formats).
· a number ’n’.
In the first case, the appointments and events list for the
specified date will be returned, while in the second case the
appointments and events list for the ’n’ upcoming days will be
As an example, typing ’calcurse -d 3’ will display your
appointments and events for today, tomorrow, and the day after
The date format used is the one specified in the ’General
options’ menu. Four formats are available:
Note: as for the ’-a’ flag, the calendar from which to
read the appointments can be specified using the ’-c’
-D <dir>, --directory <dir>
Specify the data directory to use. This option is
incompatible with -c. If not specified, the default
directory is ’~/.calcurse/’
Print a short help text describing the supported command-
line options, and then exit.
-i <file>, --import <file>
Import the icalendar data contained in file.
Print the next appointment within upcoming 24 hours and
exit. The indicated time is the number of hours and
minutes left before this appointment.
Note: the calendar from which to read the appointments
can be specified using the ’-c’ flag.
When used with the ’-a’ or ’-t’ flag, also print note
content if one is associated with the displayed item.
Print events and appointments for the num number of days
and exit. If no num is given, a range of 1 day is
Print events and appointments from date and exit. If no
date is given, the current day is considered.
When used with the ’-a’, ’-d’, ’-r’, ’-s’, or ’-t’ flag,
print only the items having a description that matches
the given regular expression.
Display the status of running instances of calcurse. If
calcurse is running, this will tell if the interactive
mode was launched or if calcurse is running in
background. The process pid will also be indicated.
Print the ’todo’ list and exit. If the optional number
num is given, then only todos having a priority equal to
num will be returned. The priority number must be
between 1 (highest) and 9 (lowest). It is also possible
to specify ’0’ for the priority, in which case only
completed tasks will be shown.
Display calcurse version and exit.
Export user data to the specified format. Events,
appointments and todos are converted and echoed to
stdout. Two possible formats are available: ical and
pcal. If the optional argument format is not given, ical
format is selected by default.
Note: redirect standard output to export data to a file,
by issuing a command such as:
$ calcurse --export > calcurse.dat
Calcurse interface contains three different panels (calendar,
appointment list, and todo list) on which you can perform different
actions. All the possible actions, together with their associated
keystrokes, are listed on the status bar. This status bar takes place
at the bottom of the screen.
At any time, the built-in help system can be invoked by pressing the
’?’ key. Once viewing the help screens, informations on a specific
command can be accessed by pressing the keystroke corresponding to that
The calcurse options can be changed from the configuration menu (shown
when ’C’ is hit). Five possible categories are to be chosen from : the
color scheme, the layout (the location of the three panels on the
screen), notification options, key bindings configuration menu, and
more general options (such as automatic save before quitting). All of
these options are detailed in the configuration menu.
The following structure is created in your $HOME directory (or in the
directory you specified with the -D option), the first time calcurse is
The notes subdirectory contains descriptions of the notes which are
attached to appointments, events or todos. One text file is created per
note, whose name is built using mkstemp(3) and should be unique, but
with no relation with the corresponding item’s description.
The conf file contains the user configuration. The keys file contains
the user-defined key bindings. The apts file contains all of the user’s
appointments and events, and the todo file contains the todo list.
Note: if the logging of calcurse daemon activity was set in the
notification configuration menu, the extra file daemon.log will appear
in calcurse data directory. This file contains logs about calcurse
activity when running in background.
This section describes the environment variables that affect how
Specifies the external editor to use for writing notes.
If the VISUAL environment variable is not set, then EDITOR will be
used as the default external editor. If none of those variables are
set, then /usr/bin/vi is used instead.
Specifies the default viewer to be used for reading notes. If this
variable is not set, then /usr/bin/less is used.
Incorrect highlighting of items appear when using calcurse black and
white theme together with a $TERM variable set to xterm-color. To fix
this bug, and as advised by Thomas E. Dickey (xterm maintainer), xterm-
xfree86 should be used instead of xterm-color to set the $TERM
"The xterm-color value for $TERM is a bad choice for
XFree86 xterm because it is commonly used for a
terminfo entry which happens to not support bce.
Use the xterm-xfree86 entry which is distributed
with XFree86 xterm (or the similar one distributed
If you find other bugs, please send a report to firstname.lastname@example.org or
to the author, below.
vi(1), less(1), ncurses(3), mkstemp(3)
The ical specification (rfc2445) can be found at:
The pcal project page: http://pcal.sourceforge.net/
Calcurse home page: http://culot.org/calcurse/
Calcurse complete manual, translated in many languages and maintained
in html format, can be found in the doc/ directory of the source
package, or at: http://culot.org/calcurse/manual.html
Frederic Culot <email@example.com>.
Copyright (c) 2004-2010 by Frederic Culot.
This software is released under the BSD License.