Chapter 2. Starting SandUhr

There are two ways to start the SandUhr program. The easy method is to use GNOME's start menu: SandUhr is installed in the System menus as Utilities->SandUhr. The program first opens a dialog to enter the alarm time. After closing this dialog the actual alarm clock launches.

Alternatively you can launch SandUhr from the command line. The calling syntax is as follows:
sanduhr [options] [time]

The time argument defines the time when the alarm action is to be triggered. It is a string whose format is explained in the following chapter. If no alarm time is given, the program opens a dialog window to enter this time there. Options may be choosen among these:

-h, --help

shows the complete list of options.

-m MSG, --message=MSG

Use MSG as the alarm message.

Example 2-1. A real-life example

When starting SandUhr from the command line, the following call may make sense. It makes SandUhr wait for three minutes and 15 seconds and, after that, emit the message "tea is ready".
% sanduhr -m "tea is ready" +3m15s