KAlarm
======

KAlarm is a personal alarm message, audio, command and email scheduler.

KAlarm provides a graphical interface to schedule personal timed events -
pop-up alarm messages, playing audio files, command execution and the sending
of emails. It has a wide range of options, including:

 * Configuring alarms to recur on an hours/minutes, daily, weekly, monthly or
   annual basis, or setting them to trigger every time you log in.

 * Choice of whether or not an alarm should be cancelled if it can't be
   triggered at its scheduled time. An alarm can only be triggered while you
   are logged in and running a graphical environment. If you choose not to
   cancel the alarm if it can't be triggered at the correct time, it will be
   triggered when you eventually log in.

Options for pop-up alarms include:

 * Speaking the message.

 * Playing a sound file when the alarm is displayed.

 * Setting a reminder to be displayed in advance of, or after, the main alarm
   time(s).

 * Selection of the alarm message's colour and font.

In addition to its graphical mode, alarms may also be scheduled from the
command line, or via D-Bus calls from other programs.

See the INSTALL file for installation instructions.


USE ON NON-KDE DESKTOPS

For details on the requirements for setting up KAlarm to run on non-KDE
desktops, see the INSTALL file.


PROGRAM STATUS

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 SPDX headers in individual source files, and the licence texts in the
LICENSES directory, for more details.


DESIGN

See DESIGN.html for some design information. DESIGN-kalarmcalendar.html contains
details of the alarm storage format.


BUGS:

Bugs can be reported to the KDE bug tracking system (http://bugs.kde.org).
There you can also get information about the status of older bugs.
KAlarm, as most other KDE programs, offers a menu item "Report Bug" in the
Help menu for convenient reporting of bugs or feature requests.


COMMENTS AND SUGGESTIONS:

Please send your comments and suggestions to
David Jarvie <djarvie@kde.org>.
