WMCLOCKMON(1)

🌸 NAME 🌸

wmclockmon — a dockapp to monitor hour, date and alarms 💅✨

---

✨ SYNOPSIS ✨

wmclockmon [options]

---

🎀 DESCRIPTION 🎀

okay bestie, so this manual page is gonna walk you through wmclockmon real quick 🫶

WMClockMon is a lil program that displays a digital clock. It's a dockapp, which means it's supported by X window managers like Window Maker, AfterStep, BlackBox and Enlightenment. Very demure, very dockable. 💖

It shows you the time and the date, an AM/PM indicator if you want one, and an alarm indicator. The whole thing has an LCD look-alike user interface ✨ (yes, the aesthetic is the point, iykyk).

• The back-light can be turned on/off by clicking mouse button 1 (left) over the application. 🖱️
• When an alarm raises, an alarm-mode will alert you by turning on and off the back-light for 1 minute and running the configured command. 🚨
• That can be stopped (and restarted) by clicking 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, bestie 😭).
• If an alarm time has been set to off (see the config file section 📁) it will not be set back on. Updating the config will allow this. periodt.

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

Clicking with 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 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 info). Moreover, today's calendar can be displayed at startup or at 00:00. In that order, the MessageCmd option is used. ⏰

---

here's the mouse-button cheat sheet, since the original gives you a whole grid and I'm giving it to you as the cutest lil nested list 🦋

• Button 1 🖱️
  • no modifier → action/backlight on-off
  • control key → internet time
• Button 2 🖱️
  • no modifier → cycle style
  • control key → configuration tool
• Button 3 🖱️
  • no modifier → blinking on/off
  • control key → 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 extension 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 extension 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 (useful 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 beginning 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 (the original literally writes noting here, bestie, it means nothing 😭). 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 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). 🗂️

🌸 MAIN STYLE FILE (.mwcs)

• PartsStyle — the file where your parts style lives.
• LettersStyle — the file where your letters style lives.
• ITimeStyle — the file where your internet time style lives.
• BacklightOn — the background pixmap for the backlight-on display, and it's 58x58 bestie, don't forget.
• BacklightOff — the background pixmap for the backlight-off display, also 58x58.
• NbColors — how many shadow colors you want.
• Hours_PosX =
• Hours_PosY = — where the hours sit, in pixels, inside the background pixmaps.
• Hours_Big — are the hours displayed big? boolean, so yes/no energy.
• Minutes_PosX =
• Minutes_PosY =
• Minutes_Big — literally the same deal as hours but for minutes.
• Seconds_PosX =
• Seconds_PosY =
• Seconds_Big — same as for hours again, seconds edition.
• Seconds_Colon — when the seconds are a blinking colon. iconic behavior honestly.
• 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 — the pixmaps for the parts of your 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 the big digits but, you guessed it, 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 the internet time display.
• IBacklightOff — same as above but for backlight off.
• Beats_PosX =
• Beats_PosY =
• Beats_Big — as usual, same as for hours.
• 10thOB_PosX =
• 10thOB_PosY =
• 10thOB_Big — same as above but for tenths of a beat.
• 10thOB_Display — do you display tenths of a beat or not? boolean, pick a lane.
• Graph_PosX =
• Graph_PosY =
• Graph_Display — same as for tenths of beat.

💜 BINARY CLOCK STYLE FILE (.bwcs)

• BBacklightOn — background pixmap for backlight on the binary clock display.
• BBacklightOff — same as above for backlight off.
• Bin_HX =
• Bin_HY = — hours bits start position (most significant bits first, no cap).
• 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 the 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 the date bits squares. And heads up bestie: specifying -1 for Bin_IX disables date displaying entirely, and then you don't need the other date specs at all. ✨
• 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>. giving credit where credit is due, periodt 🫶

---

okay that's the whole page, you made it to the end bestie!! 🎉 this lil masterpiece is WMCLOCKMON(1) and it's dated September 07, 2002 — vintage but still slaying, fr fr. go build a cute clock style, you got this 💅✨