WMCLOCKMON(1) | General Commands Manual | WMCLOCKMON(1) |
NAME¶
wmclockmon - A dockapp to monitor hour, date and alarmsSYNOPSIS¶
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.+-------------------------+-------------------------+
| no modifier | control key | +----------+-------------------------+-------------------------+ | Button 1 | action/backlight on-off | internet time | +----------+-------------------------+-------------------------+ | Button 2 | cycle style | configuration tool | +----------+-------------------------+-------------------------+ | Button 3 | blinking on/off | calendar tool | +----------+-------------------------+-------------------------+
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.
- -h, --help
- show help text and exit.
- -v, --version
- show program version and exit.
- -bl, --backlight
- 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).
- -it, --internet-time
- start with internet time (in beats).
- -i, --interval <number>
- number of secs between updates (1 is default).
- -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 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.
- -nb, --no-blink
- disable blinking when alarm raises.
- -f, --cfgfile
- load configuration file.
- -nl, --no-locale
- don't use the current locale (use the C locale instead).
- -l, --label
- use a label instead of the current date (usefull if you have multiple instances running different timezones).
- -sc, --show-cal
- show today's calendar/TODO list at startup/00:00.
- -ca, --cal-alrms
- load calendar alarms for today.
FILES¶
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 today's calendar at startup/00:00.
- CalAlrms =
- Boolean (Off). Load calendar's alarms for today.
STYLES¶
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 :)MAIN STYLE FILE (.mwcs)¶
- 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 position in pixels in the background
pixmaps.
- Hours_Big =
- hours displayed in big (boolean).
same as for hours.
Seconds_PosX =
same as for hours.
- Seconds_Colon =
- seconds are a blinking colon.
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 STYLE FILE (.pwcs)¶
- 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.
same as for big digits but for small
digits.
LETTERS STYLE FILE (.lwcs)¶
- Letters =
- pixmap for letters.
same as for big and small digits.
INTERNET TIME STYLE FILE (.iwcs)¶
- IBacklightOn =
- background pixmap for backlight on internet time display.
- IBacklightOff =
- same as above for backlight off.
as usual, same as for hours.
10thOB_PosX =
same as above for tenths of beat.
- 10thOB_Display =
- display or not tenths of beat (boolean).
same as for tenths of beat.
BINARY CLOCK STYLE FILE (.bwcs)¶
- BBacklightOn =
- background pixmap for backlight on binary clock display.
- BBacklightOff =
- same as above for backlight off.
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.
SEE ALSO¶
wmclockmon-config(1), wmclockmon-cal(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>.September 7, 2002 |