wmclock(1)

✨ wmclock — a dockable clock for Window Maker, and yes it's giving main character energy 💅

ok bestie sit down because we're about to talk about wmclock(1), a little General Commands Manual icon that lives in your dock and tells you the time. no cap, it's adorable.

---

🎀 NAME 🎀

wmclock — a dockable clock for the Window Maker window manager

---

🌸 SYNOPSIS 🌸

wmclock [{-12|-24|-year}] [-noblink] [-version] [-exe program] [-led
       color] [-monthxpm filename] [-weekdayxpm filename]

---

🦋 DESCRIPTION 🦋

so basically Wmclock is an applet that shows you the date and time in a dockable tile, styled exactly like the clock from the NEXTSTEP(tm) operating system. it was made specially for the Window Maker window manager by Alfredo Kojima, and it is lowkey stacked with features: multiple language support, twenty-four-hour and twelve-hour (am/pm) time display, and — if you want — it can run a program you pick whenever you click on it. 🖱️

fun fact: Wmclock is derived from asclock, a similar clock for the AfterStep window manager. it's giving glow-up. ✨

---

💖 OPTIONS 💖

• -12 or -24 — show the time in twelve-hour format (with am/pm) or twenty-four-hour format. defaults to twenty-four-hour display, so if you're a 24h girlie you don't gotta do anything.
• -year — display the current year in the LED display instead of the time. iconic for when you forget what year it is (it happens).
• -noblink — the separator between hours and minutes blinks by default, which is cute but distracting. this option turns off the blinking and gives you a steadily lit separator instead.
• -interval n — set the blink cycle to n seconds. the default is 2 (1 second on, 1 second off).
• -version — displays the version of Wmclock. slay, now you know.
• -exe command — run command in the background when a mouse button is pressed over wmclock. see below for the deets. 👀
• -led color — use color as the foreground color of the LED display. color can be either a named color from the rgb.txt database (like red or chartreuse) or a numeric color spec in any of the usual X11 formats (like #ff0000 or rgb:7f/ff/00). check the X(1) man page for more. 🌈
• -monthxpm filename — get month abbreviations from filename, which is expected to be in the XPM format. see below for details.
• -weekdayxpm filename — get weekday abbreviations from filename, which is expected to be in the XPM format. see below for details.

---

🌟 INVOCATION AND EXAMPLES 🌟

the simplest way to start wmclock is literally just:

wmclock

Wmclock displays in its own appicon, which you can place in Window Maker's dock by holding down the [Alt] or [Meta] key and dragging wmclock to the dock with the primary mouse button (usually the left one). drag and drop, periodt. 🫶

for a more complicated example:

wmclock -12 -led gold -exe /usr/GNUstep/Apps/WPrefs.app/WPrefs

this displays 12-hour time in an amber-colored LED display, and starts Window Maker's preferences utility when you click on wmclock. obsessed.

---

🧚 DETAILS 🧚

💀 Running Commands

when you use wmclock with the -exe option, wmclock will run the command you specify whenever you press a mouse button while the mouse cursor is over wmclock.

Wmclock uses the system(3) function from the C library (and ultimately /bin/sh) to run the command; hence, the command must be in Bourne-shell syntax. no zsh-isms, bestie, we're in sh-land. 😭

🌸 Using Alternate Month and Weekday Abbreviations

you can use the -monthxpm and -weekdayxpm options to convince wmclock to display month and day-of-week abbreviations in a language besides the one it was compiled with, or to display them in a language that wmclock does not yet support.

the files you specify must be in the XPM format, and they must follow the same strict size and placement as the month and weekday XPMs that come in the wmclock source package. here's the vibe check on sizes:

• each weekday abbreviation must be 21 pixels wide and 6 pixels high
• each month abbreviation must be 22 pixels wide and 6 pixels high

the month abbreviations must be arranged vertically, beginning with January at the top and continuing down to December at the bottom. the weekday abbreviations must also be arranged vertically, beginning with Monday at the top and continuing to Sunday at the bottom. no mixing, no chaos, we're being organized today. 💅

you can find XPM files for a variety of languages in:

/usr/share/wmclock

for example, to have a French display, you could use the following command line:

wmclock -monthxpm /usr/share/wmclock/lang.french/month.xpm
-weekdayxpm /usr/share/wmclock/lang.french/weekday.xpm

🎀 Obsolete Options

in order to maintain command-line compatibility (mostly) with asclock, wmclock accepts a few options on the command line without complaining, even though they don't have any effect. the options wmclock accepts in this manner are -shape and -iconic.

some dockable versions of asclock required one or both of these options to become properly dockable. however, since wmclock is designed for Window Maker's dock, it already displays in a shaped window in its own dockable appicon. so yeah — you can pass them, they just do nothing. it's giving "ghost options". 👻

---

😭 BUGS 😭

• Wmclock shouldn't run a command on a single click; should use a double click instead.
• Wmclock should use Alfredo Kojima's libdockapp library instead of inventing its own wheel.

ngl these are the author's own words, we're just reporting the tea. 🍵

---

🔥 SEE ALSO 🔥

X(1), asclock(1x), wmaker(1x), system(3)

---

👑 COPYRIGHT AND LICENSE 👑

Copyright (C) 1999 by Jim Knoble <jmknoble@pobox.com>. Significant portions of wmclock are directly derived from asclock by Beat Christen, who, along with asclock's other authors, owns the copyright to those portions of wmclock.

Wmclock is licensed under the GNU General Public License, version 2, or (at your option) any later version. See <http://www.gnu.org/> for more information.

---

⭐ AUTHORS ⭐

• Jim Knoble <jmknoble@pobox.com>
• Beat Christen <spiff@longstreet.ch>, author of asclock

---

🦋 DISCLAIMER 🦋

The software is provided ``as is'', without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the author(s) be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.

Your mileage may vary. Eat your vegetables. 🥦

---

and that's the whole page, bestie — this was Version 1.0.16, dated 2015-09-24, straight out of the wmclock(1) manual. go forth and dock your clock. 💖✨