Alarm List

The main KAlarm window displays the current list of pending alarms, showing their times, repetition intervals, colors, names, 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.

Note that the Name column only exists if the use of alarm names is enabled in the General tab of the Configuration dialog.

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 color column, as described in Error Handling above.

Changing the Alarm List Appearance

The alarms may be ordered by date/time, repeat interval, color, type, name 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.

You can select which columns to display or hide by Right clicking on the column headings and using the context menu to set the columns to show. But note that at least one of the Name or Message, File or Command columns, and at least one of the Time or Time To columns, are always shown.

If you use multiple alarm calendars, you can color code alarms according to which calendar they belong to, by selecting a different background color for each calendar (see Using Calendars).

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 dialog.

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

Filtering the Alarm List by Date

You can restrict the alarm list to show only alarms which are scheduled to occur on a selected date. This is achieved by means of the alarm date selector, which can be displayed or hidden by ViewShow Date Selector. Select a date by clicking on it in the date selector, or deselect it by clicking on it again. The date selector displays a single month. To display a different month, use the arrow controls in the date selector.

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 dialog, 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.