Provided by: wmclockmon_0.8.1-2ubuntu1_amd64 bug

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.

       By  clicking  on  the background with the button 1 while holding down the control key, you
       can switch to internet time display (in beats) and the same action bring back to the local
       time. You can start directly with internet time (see the -it option).

       Clicking with the mouse button 2 (middle) while holding down the control key, launches the
       configuration tool. If you don't  hold  the  control  key  down,  it  cycles  through  the
       different styles.

       Clicking  with the mouse button 3 (right) while holding down the control key, launches the
       calendar tool.

       Command-line options override the default configuration file options. But  if  a  file  is
       given at command-line (with the -f option), its options will override those given before.

       Alarms  can  be  added automatically with the included calendar (see below and wmclockmon-
       cal(1) for more informations). Moreover the today's calendar can be displayed  at  startup
       or at 00:00. In that order, the MessageCmd option is used.

                                            +-------------------------+-------------------------+
                                            | 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.

              Calendar files can be unique (for a particular day), yearly or monthly. For a  day,
              all calendar files are used (if they exist).

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_PosX =
       Hours_PosY =
              hours position in pixels in the background pixmaps.

       Hours_Big =
              hours displayed in big (boolean).

       Minutes_PosX =
       Minutes_PosY =
       Minutes_Big =
              same as for hours.

       Seconds_PosX =
       Seconds_PosY =
       Seconds_Big =
              same as for hours.

       Seconds_Colon =
              seconds are a blinking colon.

       AM_PosX =
       AM_PosY =
              same as for hours.

       PM_PosX =
       PM_PosY =
              same as for hours.

       ALRM_PosX =
       ALRM_PosY =
              same as for hours.

       Weekday_PosX =
       Weekday_PosY =
              same as for hours.

       Day_PosX =
       Day_PosY =
              same as for hours.

       Month_PosX =
       Month_PosY =
              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.

       SDigitHeight =
       SDigitWidth =
              same as for big digits but for small digits.

   LETTERS STYLE FILE (.lwcs)
       Letters =
              pixmap for letters.

       LetterHeight =
       LetterWidth =
              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.

       Beats_PosX =
       Beats_PosY =
       Beats_Big =
              as usual, same as for hours.

       10thOB_PosX =
       10thOB_PosY =
       10thOB_Big =
              same as above for tenths of beat.

       10thOB_Display =
              display or not tenths of beat (boolean).

       Graph_PosX =
       Graph_PosY =
       Graph_Display =
              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.

       Bin_HX =
       Bin_HY =
              hours bits start position (most significant bits first).

       Bin_MX =
       Bin_MY =
              minutes bits start position (most significant bits first).

       Bin_SX =
       Bin_SY =
              seconds bits start position (most significant bits first).

       Bin_ZX =
       Bin_ZY =
              size of time bits squares.

       Bin_WX =
       Bin_WY =
              week day bits start position (most significant bits first).

       Bin_DX =
       Bin_DY =
              month day bits start position (most significant bits first).

       Bin_OX =
       Bin_OY =
              month bits start position (most significant bits first).

       Bin_IX =
       Bin_IY =
              size  of  date  bits squares.  Specifying -1 for Bin_IX disable date displaying and
              other date specs are not needed.

       Bin_D1X =
       Bin_D1Y =
              space between 2 bits of the same number for the time.

       Bin_D2X =
       Bin_D2Y =
              space between 2 binary numbers of the same time part.

       Bin_D3X =
       Bin_D3Y =
              space between 2 bits of the same number for the date.

       Bin_D4X =
       Bin_D4Y =
              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 07, 2002                          WMCLOCKMON(1)