|-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.|
|show help text and exit.|
|show program version and exit.|
|turn on back-light.|
|-lc, --light-color <color>|
|back-light or LEDs color (rgb:6E/C6/3B is default for LCD looks, rgb:00/B0/EA is default for LED looks).|
|start with internet time (in beats).|
|-i, --interval <number>|
|number of secs between updates (1 is default).|
|run the application in windowed mode.|
|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 an alarm raises.|
|-mc, --message-cmd <string>|
|command to display messages when an alarm raises.|
|-12, --h12||12 hours clock mode (default is 24).|
|-s, --style <name>|
|style to use for display. If -sd is given, there is no need to give an extention since it is automatically given (.mwcs). Using this option to a .mwcs file automatically sets the styles directory if not already given. A subsequent use of -sd will overwrite it. Using another extention may give erroneous results.|
|-sd, --style-dir <directory>|
|set the directory where styles are stored.|
|disable blinking when alarm raises.|
|load configuration file.|
|dont use the current locale (use the C locale instead).|
|use a label instead of the current date (usefull if you have multiple instances running different timezones).|
|show todays calendar/TODO list at startup/00:00.|
load calendar alarms for today.
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, true/false, yes/no or on/off, case insensitive. A sample file is given in the source package.
Backlight = Boolean (off). Color = String (#6EC63B for LCD looks, #00B0EA for LED looks). Alarm = String (noting). You can have several Alarm entries. An entry is in the form of [bool@]HH:MM[-D][.M], with bool representing the alarm status (on or off), HH:MM the hours and minutes of alarm, D the number of the day it should happen and M is the message that should be displayed when this alarm raises. The bool, the D and the M values are optionals (the boolean defaults to on, no day value means every day and the message is optional). @, - and . are the separators between the each of them and the time (or the day, for the message). The alarm time HAVE to be in 24h mode and with 2 digits for hours and 2 for minutes (no spaces). The day value, if given, should be between 1 and 7. Time and day values are used with strftime (%H:%M and %u). For more examples, see samples files in package... Command = String (nothing). Command that is executed once an alarm raises (eg: ogg123 -d esd -q /home/thomas/documents/sons/alarme.ogg). MessageCmd = String (nothing). Command that is executed with the MESSAGE part of the alarm that is raised as argument. Blink = Boolean (yes). H12 = Boolean (false). Set 12h/24h clock mode. Locale = Boolean (yes). Use your current locale or not (use C locale instead). Style = String (nothing). StyleDir = String (nothing). Directory where styles are stored. TimeMode = Integer (0: normal clock, 1: internet time, 2: binary clock). ShowCal = Boolean (No). Show todays calendar at startup/00:00. CalAlrms = Boolean (Off). Load calendars alarms for today.
Calendar files can be unique (for a particular day), yearly or monthly. For a day, all calendar files are used (if they exist).
Building a new style is quite easy. A style is composed of 4 description files and several pixmaps files : a main style file, a parts style file, a letters style file and a internet time style file. Each of them contains several variables and their associated values. If only the main style file have its extension fixed to .mwcs, the others can have whatever name you want but using those given is usefull for understanding :)
PartsStyle = file where parts style is described. LettersStyle = file where letters style is described. ITimeStyle = file where internet time style is described. BacklightOn = background pixmap for backlight on display (58x58). BacklightOff = background pixmap for backlight off display (58x58). NbColors = number of shadow colors. Hours_PosX =
hours position in pixels in the background pixmaps. Hours_Big = hours displayed in big (boolean). Minutes_PosX =
same as for hours. Seconds_PosX =
same as for hours. Seconds_Colon = seconds are a blinking colon. AM_PosX =
same as for hours. PM_PosX =
same as for hours. ALRM_PosX =
same as for hours. Weekday_PosX =
same as for hours. Day_PosX =
same as for hours. Month_PosX =
same as for hours.
Parts = pixmaps for parts of graphics (big and small digits, graphs, AM/PM/ALRM). BDigitHeight = big digits height in pixels. BDigitWidth = big digits width in pixels. SDigitHeight =
same as for big digits but for small digits.
Letters = pixmap for letters. LetterHeight =
same as for big and small digits.
IBacklightOn = background pixmap for backlight on internet time display. IBacklightOff = same as above for backlight off. Beats_PosX =
as usual, same as for hours. 10thOB_PosX =
same as above for tenths of beat. 10thOB_Display = display or not tenths of beat (boolean). Graph_PosX =
same as for tenths of beat.
BBacklightOn = background pixmap for backlight on binary clock display. BBacklightOff = same as above for backlight off. Bin_HX =
hours bits start position (most significant bits first). Bin_MX =
minutes bits start position (most significant bits first). Bin_SX =
seconds bits start position (most significant bits first). Bin_ZX =
size of time bits squares. Bin_WX =
week day bits start position (most significant bits first). Bin_DX =
month day bits start position (most significant bits first). Bin_OX =
month bits start position (most significant bits first). Bin_IX =
size of date bits squares. Specifying -1 for Bin_IX disable date displaying and other date specs are not needed. Bin_D1X =
space between 2 bits of the same number for the time. Bin_D2X =
space between 2 binary numbers of the same time part. Bin_D3X =
space between 2 bits of the same number for the date. Bin_D4X =
space between 2 binary numbers of the same date part.
WMClockMon was assembled by Thomas Nemeth <email@example.com>. It is largely based on WMMemMon and WMCPULoad by Seiichi SATO <firstname.lastname@example.org> and WMMemLoad by Mark Staggs <email@example.com>.
|-->||WMCLOCKMON (1)||September 07, 2002|