Man Linux: Main Page and Category List


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

                       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’

              -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

              -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 shown.

              -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


       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
       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
           "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, below.


       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.