BEVELBAR-TIME(1)

📦 version 25.08, in nixos 26.05, nixpkgs unstable

💖 BEVELBAR-TIME 💖

okay so bestie, this is bevelbar-time — a whole little icon that shows you the date and time as text inside bevelbar. iykyk, it's the clock widget of your dreams. 🕐✨

🌸 SYNOPSIS 🌸

bevelbar-time [-f format] [-m monitor] [-s style]

🎀 DESCRIPTION 🎀

so here's the vibe: it sleeps, then it wakes up at the start of every second, then it generates output for bevelbar(1). that's it. that's the whole personality. 😭 it shows the current date and time according to the format string you hand it. literally all day, every second, no cap. 💅

the options, bestie 🫶

  • -f format — the format you feed to strftime(3) so it knows how to show the current date and time. it may contain %n, and every line you produce becomes its own segment. so yes, multi-line formatting is a serve. 🌈
  • -m monitor — only show output on this monitor. it's an integer, so go check bevelbar(1) for what those numbers mean. 🖥️
  • -s style — use this bevelbar style to display the time. slay, customise away. 👑

⭐ EXAMPLE ⭐

the whole idea is to launch bevelbar-time as a widget inside of bevelbar(1) — like nesting dolls but make it desktop. 🪆✨

#!/bin/sh
bevelbar ... 'bevelbar-time ...'

📜 LICENSE 📜

bevelbar-time is released under the MIT license. check the accompanying LICENSE file for the receipts. 🧾

🦋 HISTORY 🦋

bevelbar-time was originally written by Peter Hofmann, and the project was started in January 2016. vintage icon behaviour honestly. 🎀

👀 SEE ALSO 👀

bevelbar(1). that's the one, go read it. 🫶

fr fr bestie, that's the whole page — every flag, every path, every %n, all of it. no notes. 💜

okay and the official goodbye line: this one's from the Debian build, dated 2025-08-04, and that's the tea. 🍓🧚💫

📦 where this page comes from