.\" $calcurse: calcurse.1,v 1.5 2007/04/15 12:37:47 culot Exp $ .\" .\" Copyright (c) 2004-2007 Frederic Culot .\" .\" This program is free software; you can redistribute it and/or modify .\" it under the terms of the GNU General Public License as published by .\" the Free Software Foundation; either version 2 of the License, or .\" (at your option) any later version. .\" .\" This program is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with this program; if not, write to the Free Software .\" Foundation, Inc., 59 Temple Place - Suite 330, .\" Boston, MA 02111-1307, USA. .\" .fam C .TH CALCURSE 1 "April 15, 2007" "Version 1.8" "Calcurse Manual" .SH NAME Calcurse \- text-based organizer .SH SYNOPSIS .B "calcurse " [\fB-h\fP|\fB-v\fP] [\fB-x\fP] [\fB-an\fP] [\fB-t\fP[\fInum\fP]] [\fB-d\fP \fIdate\fP|\fInum\fP] [\fB-c\fP \fIfile\fP] .SH DESCRIPTION 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. .SH OPTIONS The following options are supported: .TP \fB-a\fP, \fB--appointment\fP Print the appointments and events for the current day and exit. .br \fINote:\fP the calendar from which to read the appointments can be specified using the '\-c' flag. .TP \fB-c\fP , \fB--calendar\fP Specify the calendar file to use. The default calendar is .B "'~/.calcurse/apts'" (see section \fIFILES\fP below). .TP \fB-d\fP , \fB--day\fP 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: .RS 9 .TP 2 \(bu a date of the form 'mm/dd/yyyy'. .TP 2 \(bu a number 'n'. .RE .RS 7 .LP 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. .br As an example, typing 'calcurse -d 3' will display your appointments and events for today, tomorrow, and the day after tomorrow. .br \fINote:\fP as for the '-a' flag, the calendar from which to read the appointments can be specified using the '\-c' flag. .RE .TP \fB-h\fP, \fB--help\fP Print a short help text describing the supported command-line options, and then exit. .TP \fB-n\fP, \fB--next\fP Print the next appointment within upcoming 24 hours and exit. The indicated time is the number of hours and minutes left before this appointment. .br \fINote:\fP the calendar from which to read the appointments can be specified using the '\-c' flag. .TP \fB-t\fP[num], \fB--todo\fP[=num] Print the 'todo' list and exit. If the optional number \fInum\fP is given, then only todos having a priority equal to \fInum\fP will be returned. .br \fINote:\fP priority number must be between 1 (highest) and 9 (lowest). .TP \fB-v\fP, \fB--version\fP Display calcurse version and exit. .TP \fB-x\fP, \fB--export\fP Export user data to iCalendar format. Events, appointments and todos are converted and echoed to stdout. .br \fINote:\fP redirect standard output to export data to a file, by issuing a command such as: .br .B $ calcurse --export > my_data.ics .SH NOTES 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. .PP 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. .SH CONFIGURATION The calcurse options can be changed from the configuration menu (shown when 'C' is hit). Four possible categories are to be chosen from : the color scheme, the layout (the location of the three panels on the screen), notification options, and more general options (such as automatic save before quitting). All of these options are detailed in the configuration menu. .SH FILES The following structure is created in your $HOME directory the first time calcurse is run : .PP .HP 10 $HOME/.calcurse/ .br |___conf .br |___apts .br |___todo .PP The \fIconf\fP file contains the user configuration. The \fIapts\fP file contains all of the user's appointments, and the \fItodo\fP file contains the todo list. .SH LICENCE Copyright (c) 2004-2007 by Frederic Culot. .br This software is released under the GNU General Public License. Please read the COPYING file for more information. .SH BUGS Incorrect highlighting of items appear when using calcurse black and white theme together with a \fB$TERM\fP variable set to \fIxterm-color\fP. To fix this bug, and as advised by Thomas E. Dickey (xterm maintainer), \fIxterm-xfree86\fP should be used instead of \fIxterm-color\fP to set the \fB$TERM\fP 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)." .PP If you find other bugs, please send a report to calcurse@culot.org or to the author, below. .SH AUTHOR \fBFrederic Culot\fP . .SH SEE ALSO ncurses(3), gettext(3) .br Calcurse home page : http://culot.org/calcurse/ .br Calcurse manual found in the doc/ directory of the source package, or at: http://culot.org/calcurse/manual.html