GRDC(6)

📦
version 15.1 · 2 versions
, in freebsd 15.1

🌈 GRDC(6) — the grand digital clock (curses) 💅

okay bestie, so this is grdc, the grand digital clock — a curses-era icon that draws a clock out of reverse-video blanks on your terminal. yes, blanks. reverse-video blanks. it's giving minimalism, it's giving 1990s, it's giving main character energy 🎀

✨ SYNOPSIS ✨

grdc [-st] [n]
grdc -c n

🕰️ DESCRIPTION 🕰️

grdc runs a digital clock made of reverse-video blanks on a curses compatible VDU screen. that's the whole vibe. no tiny fonts, no graphics, just vibes and inverse video 🦋

  • n — an optional numeric argument. pass it and the clock stops after n seconds (default never, i.e. it just keeps going forever like your group chat at 2am 😭)

the clock can also act as a countdown timer with the -c flag — n then specifies the number of seconds to time for ⏳

  • -s — optional flag that makes digits scroll as they change ✨
  • -t — optional flag that tells grdc to output the time in a 12-hour format 🕛
  • -c — countdown timer mode, with n being the number of seconds to time for 🔥
ngl, there's a heads-up in this curses mode implementation: the scrolling option has trouble keeping up 💀 like it's trying its best but it's lowkey falling behind. iconic behavior honestly.

🌸 ENVIRONMENT 🌸

  • TZ — the time zone to use for displaying the time. it's normally specified as a pathname relative to /usr/share/zoneinfo, though see tzset(3) for more information 👀 if this variable is not set, the time zone is determined based on /etc/localtime 🫶

⚠️ NOTES ⚠️

in countdown timer mode, specifying -n > 360000 seconds (that's 100 hours, bestie, a whole situation) will lead to the counter displaying incorrect remaining time 😭

BUT — and this is the slay part — it will time correctly, and it displays correctly when the remaining time becomes less than 100 hours 💖 so like. it's fine. it recovers. it's giving comeback arc.

👑 AUTHORS 👑

  • Amos Shapir
  • modified for curses by John Lupien
  • countdown timer mode by Gavin Atkinson

legends, all of them, fr fr 🫶

Debian · January 15, 2023 · GRDC(6) — and that's the page, bestie! go set a countdown and watch those reverse-video blanks do their thing 💅✨🎀

📦 where this page comes from