KAlarm                                                  Written by David Jarvie 

Version 2.5.1 for KDE 4

A personal alarm message, command and email scheduler for KDE.


DESCRIPTION

KAlarm provides a graphical interface to schedule personal timed events -
pop-up alarm messages, 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 the main alarm time(s).

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

As an alternative to using the graphical interface, you can schedule alarms
from the command line or via DCOP calls from other programs. KAlarm is
KDE-based, but will also run on other desktops.

See the INSTALL file, or INSTALL.html, 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, or INSTALL.html.


LANGUAGE SUPPORT

KAlarm will run in a number of languages, thanks to the efforts of the KDE
translation teams. Its user interface has been completely or nearly
completely translated into:
    Catalan, Catalan (Valencia), Chinese (simplified), Chinese (traditional),
    Czech, Danish, Dutch, English (UK), English (US), Estonian, French,
    Gallegan, German, Greek, Hungarian, Italian, Japanese, Khmer, Latvian,
    Norwegian (bokmaal), Norwegian (Nynorsk), Polish, Portuguese,
    Portuguese (Brazil), Russian, Low Saxon, Spanish, Swedish, Ukrainian.
It has been translated reasonably into:
    Bulgarian, Chhattisgarhi, Finnish, Georgian, Hindi, Slovak, Slovenian,
    Turkish.
Languages supported to a lesser extent are:
    Basque, Czech, Gaelic (Ireland), Kazakh, Korean, Lithuanian, Maithili,
    Nepali, Occitan, Persian, Punjabi, Romanian.

Documentation is available in English (both American and British) and, in
various states of revision/completeness, Danish, Estonian, French, German,
Portuguese, Portuguese (Brazil), Spanish, Swedish.

See the INSTALL file, or INSTALL.html, for how to access the languages you
require.


SOFTWARE COMMON TO KDEPIM

KAlarm is part of the KDE package 'kdepim' in KDE 4. This KAlarm package is a
standalone version of KAlarm for use if 'kdepim' is not installed, or to update
the KAlarm version provided by 'kdepim'.

The following libraries are copied from the latest version of the KDE packages
'kdepim' and 'kdepimlibs', and are used if necessary, depending on which KDE
version KAlarm is being built for. KAlarm incorporates them internally, so
there is no compatibility problem with any other KDE applications. The versions
in this package omit functionality not required by KAlarm.

* libkdepim: general functions used by kdepim.
* libkholidays: holiday definitions for various countries/regions.


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 COPYING file for more details.


BUGS, COMMENTS AND SUGGESTIONS:

Bug reports, comments and suggestions are welcome. Please send them to
David Jarvie <software@astrojar.org.uk>.

The file BUGS.html contains a list of known bugs, and a wish list of new features.
