XARCLOCK(1)

💖 XARCLOCK(1) 💖

okay bestie, come sit with me because this one is SO fun. we're talking about xarclock, a lil program from the X Version 11 era that is basically an extended xclock(1). it's giving clock but with ✨opinions✨. it's an analog or digital clock, it can go forwards or backwards, and it comes with a whole glow-up over the original. let's get into it 🎀

---

🌸 NAME 🌸

xarclock — the extended xclock(1), no cap. same energy, more features. 💅

---

✨ SYNOPSIS ✨

xarclock [-roman] [-arabic] [-south] [-north] [-analog] [-digital]
[-chime] pixels] [-fg color] [-bg color] [-hd color] [-hl color] [-bd
color] [-fn fontname] [-help] [-padding pixels] [-rv] [-update seconds]
[-display displayname] [-geometry geom]

(yeah the -chime] pixels] bit is exactly how it's written, i'm not touching it, i don't make the rules 🙈)

---

🦋 DESCRIPTION 🦋

so xarclock displays the time, analog or digital, reverse or normal form. it keeps updating the time continuously, at a frequency that you get to pick. iconic, honestly.

it's based on the program xlock(1) that ships along with the X11 release, and honestly it's nothing more than a wrapper around the Athena Clock widget. a very cute wrapper though.

but here's the main character moment: this program is an extension of the standard X clock widget. the new features are:

• configurable direction of rotation 🔄
• font support in analog mode 🔤

periodt. 💅

---

👑 OPTIONS 👑

Xarclock accepts all of the standard X Toolkit command line options along with these extra ones:

• -roman — says you want roman digits on your analog clock. very classic, very demure.
• -arabic — says you want arabic digits on the analog clock. this is the default ✨
• -south — picks the direction the clock turns: on the southern half of the earth, the 3 (early afternoon) is on the left side. this is the default 🌏
• -north — says the clock will behave like xclock(1). going back to the classics, respect.
• -analog — indicates a conventional 12 hour clock face with tick marks and hands. this is the default 🕐
• -digital (or -d) — indicates a 24 hour digital clock. numbers girlies rise 🕗
• -chime — indicates the clock should chime once on the half hour and twice on the hour. 🔔 bestie it's going to be so loud
• -hd color (or -hands color) — the color of the hands on an analog clock. default is black.
• -hl color (or -highlight color) — the color of the edges of the hands on an analog clock. this is only useful on color displays. default is black.
• -fn fontname — sets the name of the used fonts on the analog clock to fontname. 🎀
• -help — indicates a brief summary of the allowed options should be printed on the standard error.
• -padding pixels — the width in pixels of the padding between the window border and the clock text or picture. default is 10 on a digital clock and 8 on an analog clock.
• -update seconds — the frequency in seconds at which xclock should update its display. if the clock is obscured and then exposed, it gets updated immediately. a value of less than 30 seconds will enable a second hand on an analog clock. default is 60 seconds.

---

🎀 X DEFAULTS 🎀

this program uses the Athena Clock widget, so it understands all of the core resource names and classes, plus these:

• width (class Width) — the width of the clock. default for analog clocks is 164 pixels; default for digital clocks is whatever is needed to hold the clock when displayed in the chosen font.
• height (class Height) — the height of the clock. default for analog clocks is 164 pixels; default for digital clocks is whatever is needed to hold the clock when displayed in the chosen font.
• update (class Interval) — the frequency in seconds at which the time should be redisplayed.
• foreground (class Foreground) — the color for the tic marks. the default depends on whether reverseVideo is specified: if reverseVideo is specified the default is lwhite, otherwise the default is black.
• hands (class Foreground) — the color of the insides of the clock's hands. the default depends on whether reverseVideo is specified: if reverseVideo is specified the default is lwhite, otherwise the default is black.
• highlight (class Foreground) — the color used to highlight the clock's hands. the default depends on whether reverseVideo is specified: if reverseVideo is specified the default is lwhite, otherwise the default is black.
• analog (class Boolean) — whether or not an analog clock should be used instead of a digital one. default is True.
• roman (class Boolean) — whether roman or arabic digits should be used on the analog clock. default is True.
• north (class Boolean) — whether or not reverse direction of rotation of hands of the analog clock should be used. default is False.
• chime (class Boolean) — whether or not a bell should be rung on the hour and half hour.
• padding (class Margin) — the amount of internal padding in pixels to be used. default is 8.
• font (class Font) — the font to be used for the digital clock. ⚠️ note that variable width fonts currently will not always display correctly.

---

🧚 WIDGETS 🧚

so if you wanna specify resources, it lowkey helps to know the hierarchy of the widgets that compose xclock. in the notation below, indentation indicates hierarchical structure. the widget class name comes first, followed by the widget instance name. iykyk.

XClock  xclock
        Clock  clock

---

🌈 ENVIRONMENT 🌈

• DISPLAY — to get the default host and display number.
• XENVIRONMENT — to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

---

🍓 FILES 🍓

• /usr/X11R6/lib/X11/app-defaults/XClock — specifies required resources.

---

💜 COPYRIGHT 💜

original code is copyrighted by Digital Equipment Corporation and the Massachusetts Institute of Technology. the modifications made by Jaime Garcia-Ghirelli (jaime@inforamp.net) remain in the public domain.

this manual page is a mixture of recycled xclock(1) stuff and new stuff by Martin Schulze (Martin.Schulze@linux.de).

---

⭐ SEE ALSO ⭐

X(1), xclock(1), xrdb(1), time(3C), Athena Clock widget.

---

okay that's the whole thing bestie, you're officially a xarclock expert, go forth and rotate your clock the wrong way on purpose 💅🕰️

this page came to you from X11, dated 29 May, 1996 — yeah it's vintage, and vintage is a vibe, no notes. mwah. 🎀