TzClock(1)

🕰️ TzClock — it's giving world clock, bestie 💖

okay so this is from the General Commands Manual section (iykyk), and it's literally about showing you the time all around the world. let's get into it ✨

✨ NAME ✨

TzClock — display the time around the world 🌍🦋

✨ SYNOPSIS ✨

TzClock [OPTION]...

✨ DESCRIPTION ✨

TzClock can display the time around the world, no cap. it supports multiple faces showing different time zones, so you can have a whole little squad of clocks going at once 👑. there's also a stopwatch that's accurate to a tenth of a second (she's precise, she's that girl 💅). plus a bunch of other nice features for you to discover — go explore, bestie 🎀

---

Options 🌸

• -a — toggle always on top. she stays in front, main character energy only ✨
• -A — hh:mm:msg set the alarm message to be shown at the specified time. for example: -A17:30:"Time to go home"
• -b — toggle showing the small second hand 🕰️
• -B — toggle showing the second hand bounce (yes, the little wiggle, iconic) 🦋
• -c — nnn#RRGGBB change one of the clock colours. the details of the codes are down below in the colours section, fr fr. for example: -cfce#1267FF
• -C — config.file specify the configuration file to use. this file should be in your home directory. the default file is: .tzclockrc
• -d — nnn:format change one of the date formats. the format is the same as the date command, with some extras sprinkled on top. details of the codes are below. for example: -dftl:"%*"
• -f — face select the face. for future settings, the faces are numbered left to right, top to bottom. some settings — like timezone — only affect one face, so you gotta select the face first, periodt
• -F — font select the font to use on the clock face 💜
• -h — switch off the second hand
• -H — <name>:s:l:t set the hand style. the name can be: hour, minute, second, sub_second, stopwatch or alarm. (s) the style is a number from [0-5], altho not all of the styles are actually defined. (l) the length of the hand from the centre. (t) the length of the tail in the other direction to the hand. 0 Quadratic (default), 1 Triangle, 2 Rectangle, 3 Pointer, 4 Arrow, 5 Simple line.
• -i — use the clock icon from the current theme 🌈
• -l — toggle locking the screen position — that means no drag and drop, she's staying put
• -m — ts set the marker type and step, default is -m13. (t) the marker type, (s) the step controls which hours have markers. 0 No markers, 1 Triangles (default), 2 Circles, 3 Latin digits, 4 Roman numerals.
• -n — cnum or rnum set the number of columns and rows. heads up: the maximum number of clocks is 36, with no more than 10 in a line. for example: -nc5 -nr3
• -o — city specify your own city name for a timezone 🏙️
• -q — quick time setting, no smooth scrolling (she's efficient 💅)
• -s — size set the size of each clock. the size gets rounded to a multiple of 64.
• -S — enable the stopwatch ⏱️
• -w — put on all work-spaces
• -x — posn set the X screen position
• -y — posn set the Y screen position. note: both X and Y must be set, so don't be doing just one, bestie 🙈
• -z — zone select timezone to display. for example: -zLondon
• -24 — show a 24 hour clock 🕛
• -? — show command line help information

---

🌈 COLOURS 🌈

so to change one of the colours you need to enter the colour's code. see the details of the -c option up above 💖

• cbf — Clock outer border when the face has focus.
• cbn — Clock outer border when the face does not have focus.
• cbi — Clock inner border.
• fce — Main clock face colour.
• fsw — Stopwatch face colour.
• txt — Colour of the text.
• cbf — Clock border when focused.
• cbn — Clock border not focused.
• cbi — Clock border inner circle.
• fce — Clock face colour.
• fsw — Stopwatch dial colour.
• txt — Information text colour.
• hrh — Hour hand outer colour.
• hhf — Hour hand fill colour.
• mnh — Minute hand outer colour.
• mhf — Minute hand fill colour.
• sch — Second hand outer colour.
• shf — Second hand fill colour.
• alh — Alarm hand outer colour.
• ahf — Alarm hand fill colour.
• swh — Stopwatch hand outer colour.
• swf — Stopwatch hand fill colour.
• hrm — Hour marker colour.
• mnm — Minute marker colour.
• swm — Stopwatch marker colour.
• qum — Quarter marker colour.
• qmf — Quarter marker fill colour.

ngl, cbf, cbn, cbi, fce, fsw and txt each show up twice in that list. that's exactly how the original page has it — I'm not merging them, I'm not fixing them, I'm just reporting the vibes 💀

---

🎀 DATES 🎀

to change the format of one of the dates you need its code, bestie ✨

• ftl — Clock top in local-time.
• ftz — Clock top for timezone.
• stl — Stopwatch top in local-time.
• stz — Stopwatch top for timezone.
• fbl — Clock bottom in local-time.
• fbz — Clock bottom for timezone.
• sbl — Stopwatch bottom in local-time.
• sbz — Stopwatch bottom for timezone.
• wtl — Window title in local-time.
• wtz — Window title for timezone.
• cbl — Copy date time in local-time.
• cbz — Copy date time for timezone.
• cdl — Copy date in local-time.
• cdz — Copy date for timezone.
• ctl — Copy time in local-time.
• ctz — Copy time for timezone.

---

🌸 DATE FORMAT 🌸

to specify a date format you can use the same format as the date command — that way your locale info gets used, slay 🌍. and on top of the date command's stuff, there are a few extras defined just for TzClock:

• %# — Time zone city, upper-cased and wrapped.
• %* — Time zone city.
• %@ — Time zone area.
• %& — Stopwatch time: h:mm:ss.hh.

---

⭐ EXAMPLE ⭐

here's an example showing the command line for displaying four clocks showing different time zones, with changes to one of the colours and one of the dates 👑

TzClock -l -nr2 -nc2 -f1 -u -f2 -h -u -z"Moscow" -f3 -h -u -z"London"
-f4 -h -u -z"New York" -s128 -ccbn"#000000" -x100 -y200 -dwtl:"%H:%M,
%a. %-d %b."

---

👑 AUTHOR 👑

Written by Chris Knight.

😭 REPORTING BUGS 😭

Report bugs to <chris@theknight.co.uk>.

💜 SEE ALSO 💜

date(1)

---

🫶 and that's the whole page, bestie. this one's from the General Commands Manual, and the page itself is dated 11 Nov 2009 — yeah, she's been serving accurate time since way back. vintage but iconic 💖✨🕰️