Alarm List

The main KAlarm window displays the current list of pending alarms, showing their times, repetition intervals, colours, and message texts, names of files to play or display, commands to execute or email subjects. (For a recurring alarm, the time shown is its next scheduled trigger time. For an alarm with a reminder, the time shown is the time of the alarm proper, not the reminder time.) An icon at the left of each alarm text/file/command/email subject indicates the type of alarm.


Main window

For a repeated alarm, the list shows its next scheduled trigger time and its basic repetition interval (e.g. 1 Day for a daily recurrence, 3 Weeks for a recurrence which triggers on Monday and Wednesday every third week, Login for a repeat-at-login alarm).

If an execution error occurred the last time a command alarm triggered, or the last time a display alarm's pre- or post-alarm command was executed, an error indication is shown in the colour column, as described in Error Handling above.

Changing the Alarm List Appearance

The alarms may be ordered by date/time, repeat interval, colour, type or text by clicking on the titlebar for the appropriate column. To reverse the sort order, click the column titlebar again.

You can optionally show the remaining time until each alarm is due, together with, or instead of, the alarm's scheduled time. To show or hide the alarm time column, select ViewShow Alarm Times. To show or hide the time-to-alarm column, select ViewShow Time To Alarms. At least one of these columns is always shown.

If you use multiple alarm calendars, you can colour code alarms according to which calendar they belong to, by selecting a different background colour for each calendar.

Archived Alarms

By default, KAlarm archives alarms for a limited period once they have expired or been deleted. (But note that alarms which you delete are stored only if they have already triggered at least once.) You can control whether KAlarm archives expired alarms, and for how long, in the Configuration dialogue.

Archived alarms may be shown in the alarm list by selecting ViewShow Archived Alarms. To hide them again, deselect ViewShow Archived Alarms.

Searching the Alarm List

You can search through the alarm list to find alarms containing a search text. To invoke this, select EditFind.... In the search dialogue, select the alarm types which you wish to search. To continue searching for more alarms which match, use EditFind Next or EditFind Previous.

Searching is performed as follows:

  • Text message alarms: the message text is searched.

  • File display alarms: the file path/URL is searched.

  • Command alarms: the command line or command script is searched.

  • Email alarms: in addition to the subject and body of the email, the recipients and the URLs of attachments are searched.

  • Audio alarms: the file path/URL is searched.

Note

Only alarms currently shown in the alarm list can be selected for searching. So if you want to search archived alarms, you must first display them as described in the section above.