Provided by: calcurse_2.8-1_amd64 bug


       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:

       -a, --appointment
              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

                ·  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 returned.
              As an example, typing 'calcurse -d 3' will display your appointments and events for
              today, tomorrow, and the day after tomorrow.
              The  date  format  used  is  the one specified in the 'General options' menu.  Four
              formats are available:

                       1. mm/dd/yyyy

                       2. dd/mm/yyyy

                       3. yyyy/mm/dd

                       4. yyyy-mm-dd

                     Note: as for the '-a' flag, the calendar from which to read the appointments
                     can be specified using the '-c' flag.

              -D <dir>, --directory <dir>
                     Specify  the data directory to use. This option is incompatible with -c.  If
                     not specified, the default directory is '~/.calcurse/'

              -h, --help
                     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.

              -n, --next
                     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.

              -N, --note
                     When  used  with  the  '-a'  or '-t' flag, also print note content if one is
                     associated with the displayed item.

              -r[num], --range[=num]
                     Print events and appointments for the num number of days and exit. If no num
                     is given, a range of 1 day is considered.

              -s[date], --startday[=date]
                     Print  events and appointments from date and exit.  If no date is given, the
                     current day is considered.

              -S<regex>, --search=<regex>
                     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.

              -t[num], --todo[=num]
                     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

              -v, --version
                     Display calcurse version and exit.

              -x[format], --export[=format]
                     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 command.


       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 run:


       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
       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 calcurse operates.

           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 variable:
           "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
            with ncurses)."

       If  you  find  other  bugs,  please  send a report to or to the author,


       vi(1), less(1), ncurses(3), mkstemp(3)
       The ical specification (rfc2445) can be found at:
       The pcal project page:
       Calcurse home page:
       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:


       Frederic Culot <>.


       Copyright (c) 2004-2010 by Frederic Culot.
       This software is released under the BSD License.