WMCLOCKMON

NAME

wmclockmon - A dockapp to monitor hour, date and alarms

SYNOPSIS

wmclockmon [options]

DESCRIPTION

This manual page documents briefly the wmclockmon command.

WMClockMon is a program to display a digital clock. It is a dockapp that is supported by X window managers such as Window Maker, AfterStep, BlackBox, and Enlightenment.

It displays time and date, an AM/PM indicator if wanted and an alarm indicator. It has an LCD look-alike user interface. The back-light may be turned on/off by clicking the mouse button 1 (left) over the application. When alarm raises, an alarm-mode will alert you by turning on and off back-light for 1 minute and running the configured command. This can be stopped (and restarted) by clicking the mouse button 3 (right) over the application. Clicking on AM or PM will toggle 12h/24h clock mode, and clicking on ALRM will toggle alarm mode (you should have alarms for that). If an alarm time has been set to off (see config file section) it will not be set back on. Updating the config will allow this.

OPTIONS

This program follows the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.

-d, --display <string>: Attempt to open a window on the named X display. In the absence of this option, the display specified by the DISPLAY environment variable is used.
-bl, --backlight: turn on back-light.
-lc, --light-color <color>: back-light color. (rgb:6E/C6/3B is default)
-i, --interval <number>: number of secs between updates. (1 is default)
-h, --help: show help text and exit.
-v, --version: show program version and exit.
-w, --windowed: run the application in windowed mode
-bw, --broken-wm: activate broken window manager fix
-a, --alarm <HH:MM>: set alarm time to HH:MM (24h clock mode)
-c, --alarm-cmd <string>: command to launch when alarm raises
-12, --h12: 12 hours clock mode (default is 24)
-s, --style <number>: style tu use for display (0 is default)
-nb, --no-blink: disable blinking when alarm raises
-f, --cfgfile: load configuration file

FILE

wmclockmon uses one default file : ~/.wmclockmonrc. Empty lines or lines begining with a # are ignored. Entries are summarized below (default value in parenthesis). Booleans can be either 1/0 or true/false or yes/no or on/off, case insensitive. A sample file is given in the source package.

Backlight =: Boolean (off).
Color =: String (#6EC63B).
Alarm =: String (noting). You can have several Alarm entries. An entry is in the form of bool@HH:MM-D, with bool representing the alarm status (on or off), HH:MM the hours and minutes of alarm, and D the number of the day it should happen. The bool and the D values are optionals (the boolean defaults to on, and no day value means 'every day') : @ and - are the separators between them and the hour. The alarm hour HAVE to be in 24h mode and with 2 digits for hours and minutes. The day value, if given, should be between 1 and 7. These values are used with strftime (%H:%M and %u).
Command =: String (nothing).
Blink =: Boolean (yes).
H12 =: Boolean (false). Set 12h/24h clock mode.
Style =: Integer (1).

AUTHOR

WMClockMon was assembled by Thomas Nemeth <tnemeth@free.fr>. It is largely based on WMMemMon and WMCPULoad by Seiichi SATO <ssato@sh.rim.or.jp> and WMMemLoad by Mark Staggs <me@markstaggs.net>.