docs.kde.org
Alarm List
Prev
Next

Alarm List

The main KAlarm window displays the current list of pending alarms, showing their times, repetition intervals, colors, and message texts, names of files to 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 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 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 View->Show Alarm Times. To show or hide the time-to-alarm column, select View->Show Time To Alarms. At least one of these columns is 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.

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 View->Show Archived Alarms. To hide them again, deselect View->Show Archived Alarms.

Searching the Alarm List

You can search through the alarm list to find alarms containing a search text. To invoke this, select Edit->Find.... In the search dialog, select the alarm types which you wish to search. To continue searching for more alarms which match, use Edit->Find Next or Edit->Find 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.

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.

Prev
Next
Contents


docs.kde.org