.TH KALARM 1 .SH NAME kalarm \- Personal alarm message, command and email scheduler for TDE .SH SYNOPSIS .B kalarm .I [Qt-options] [TDE-options] [options] [message] .SH DESCRIPTION \fBKAlarm\fP is a personal alarm message, command and email scheduler. It lets you set up personal alarm messages which pop up on the screen at the chosen time, or you can schedule commands to be executed or emails to be sent. .SH PROGRAM OPTIONS .TP .B -a, --ack-confirm Prompt for confirmation when alarm is acknowledged. .TP .B -A, --attach \fI<url>\fB Attach file to email (repeat as needed). .TP .B --auto-close Auto-close alarm window after --late-cancel period. .TP .B --bcc Blind copy email to self. .TP .B -b, --beep Beep when message is displayed. .TP .B -c, --color \fI<color>\fB Message background color (name or hex 0xRRGGBB). .TP .B -C, --colorfg \fI<color>\fB Message foreground color (name or hex 0xRRGGBB). .TP .B --calendarURL \fI<url>\fB URL of calendar file. .TP .B --cancelEvent \fI<eventID>\fB Cancel alarm with the specified event ID. .TP .B -d, --disable Disable the alarm. .TP .B -e, --exec \fI<commandline>\fB Execute a shell command line. .TP .B --edit \fI<eventID>\fB Display the alarm edit dialog to edit the specified alarm. .TP .B -n, --edit-new Display the alarm edit dialog to edit a new alarm. .TP .B --edit-new-preset \fI<templateName>\fB Display the alarm edit dialog, preset with a template. .TP .B -f, --file \fI<url>\fB File to display. .TP .B -F, --from-id \fI<ID>\fB KMail identity to use as sender of email. .TP .B --handleEvent \fI<eventID>\fB Trigger or cancel alarm with the specified event ID. .TP .B -i, --interval \fI<period>\fB Interval between alarm repetitions. .TP .B -k, --korganizer Show alarm as an event in KOrganizer. .TP .B -l, --late-cancel \fI<period>\fB Cancel alarm if more than 'period' late when triggered. .TP .B -L, --login Repeat alarm at every login. .TP .B -m, --mail \fI<address>\fB Send an email to the given address (repeat as needed). .TP .B -p, --play \fI<url>\fB Audio file to play once. .TP .B -P, --play-repeat \fI<url>\fB Audio file to play repeatedly. .TP .B --recurrence \fI<spec>\fB Specify alarm recurrence using iCalendar syntax. .TP .B -R, --reminder \fI<period>\fB Display reminder in advance of alarm. .TP .B --reminder-once \fI<period>\fB Display reminder once, before first alarm recurrence. .TP .B -r, --repeat \fI<count>\fB Number of times to repeat alarm (including initial occasion). .TP .B --reset Reset the alarm scheduling daemon. .TP .B -s, --speak Speak the message when it is displayed. .TP .B --stop Stop the alarm scheduling daemon. .TP .B -S, --subject Email subject line. .TP .B -t, --time \fI<time>\fB Trigger alarm at time [[[yyyy-]mm-]dd-]hh:mm, or date yyyy-mm-dd. .TP .B --tray Display system tray icon. .TP .B --triggerEvent \fI<eventID>\fB Trigger alarm with the specified event ID. .TP .B -u, --until \fI<time>\fB Repeat until time [[[yyyy-]mm-]dd-]hh:mm, or date yyyy-mm-dd. .TP .B -V, --volume \fI<percent>\fB Volume to play audio file. .TP .B message Message text to display. .so kdeopt.part .SH SEE ALSO More detailed user documentation is available from .BR help:/kalarm (either enter this URL into \fBkonqueror\fP, or run `khelpcenter help:/kalarm').