Calcurse - text-based organizer

calcurse [ -h | -v ] [ -at ] [ -d date|num ] [ -c file ]

Calcurse is a text-based personal organizer which helps keeping track of events and everyday tasks. It contains a calendar, a 'todo' list, and puts your appointments in order. The user interface is configurable, and one can choose between different color schemes and layouts. All of the commands are documented within an online help system.

The following options are supported:

-a

Print the appointments for the current day and exit.

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

-c

Specify the calendar file to use. The default calendar is '~/.calcurse/apts' (see section FILES below).

-d

Print the appointments for the given date or for the given number of upcoming days, depending on the argument format. Two possible formats are supported:

• a date of the form 'mm/dd/yyyy'.

• a number 'n'.

In the first case, the appointment list for the specified date will be returned, while in the second case the appointment list for the 'n' upcoming days will be returned.

As an example, typing 'calcurse -d 3' will display your appointments for today, tomorrow, and the day after tomorrow.

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

-h

Print a short help text describing the supported command-line options, and then exit.

-t

Print the 'todo' list and exit.

-v

Display calcurse version and exit.

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). Three possible categories are to be chosen from : the color scheme, the layout (the location of the three panels on the screen), 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 the first time calcurse is run :

$HOME/.calcurse/

|___conf

|___apts

|___todo

The conf file contains the user configuration. The apts file contains all of the user's appointments, and the todo file contains the todo list.

Copyright (c) 2004-2005 by Frederic Culot.

This software is released under the GNU General Public License. Please read the COPYING file for more information.

Please send bug reports and feedback to calcurse@culot.org or to the author, below.

Frederic Culot <frederic@culot.org>.

ncurses(3)

Calcurse home page : http://culot.org/calcurse/