OSDClock(1)

📦 version 0.5, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 NAME 💖

osd_clock — an X on-screen clock displayer, aka the little time fairy that lives on top of your screen 🕐✨

🌸 SYNOPSIS 🌸

osd_clock [OPTION]... [+FORMAT]

🦋 DESCRIPTION 🦋

Bestie. It displays date/time information on screen. That's the whole vibe. 💅

  • -f FONT — sets the font, so you can pick exactly how cute (or how chaotic) the numbers look 🎀
  • -c COLOR — sets the color, because yes, the clock deserves a whole aesthetic 🌈
  • -d DELAY — sets the delay (in seconds) that the clock is exposed. Super handy when you're pairing it with INTERVAL 👀
  • -F FORMAT — specifies the format used to output the date. Go check strftime(3) for the full menu of format spells, iykyk 🔥
  • -i INTERVAL — specifies the interval between displays. Default is 1 (so like… display every second, bestie) ⏱️
  • -H INTEGER — the "chimes per hour" count, and it overrides -i. Default is 0 (no effect).

The time will be displayed this many times each hour — notwithstanding signals interrupting sleep, and leap seconds, because the universe is messy like that 💀 The first display of the hour will be on the hour exactly. Use -H 4 for a display at 0, 15, 30 and 45 minutes past. Slay scheduling ✨

  • -s SHADOW — sets the shadow depth. Default 2. Shadow = main character energy, lowkey 🫶
  • -t — locate clock at top left (default: bottom left) ⬆️
  • -b — locate clock at bottom left (default) ⬇️
  • -o OFFSET — specifies the offset from the top or bottom of screen that the text is displayed. Default is 0. Useful to move above or below panels or applets — yes, it dodges your panels, we love a flexible icon 🧚
  • -h, --help — display this help and exit 🙈

😭 BUGS 😭

The per-hour mode may fire up to one second late, or worse if the system is busy. Fr fr, it's not being rude, it's just busy 🥲

👑 AUTHOR 👑

  • Jon Beckham <leftorium@leftorium.net>
  • Martijn van de Streek <martijn@foodfight.org>
  • Nathan Walp <faceprint@faceprint.com>

It is distributed under the GNU General Public License.

Okay that's the whole page, bestie — X OSD Clock, March 2001. Go forth and put a clock on literally everything 💜💅✨
📦 where this page comes from