BBTIME(1)

✨ BBTIME — bestie's guide to the little clock 💖

okay so this is bbtime, from the General Commands Manual section (section 1, iykyk), and it's literally just here to put the time on your screen in a tiny little blackbox-style window. adorable. let's go.

---

🎀 NAME 🎀

bbtime — Display the time in a small blackbox style window ✨

---

🌸 SYNOPSIS 🌸

bbtime [-display <displayname>] [-config <filename>]
       [-spooldir] [-version] [-help] [[-position] | [-pos]] <position>

like. she takes a bunch of optional stuff and possibly a position. no cap.

---

🦋 DESCRIPTION 🦋

so this manual page documents briefly the bbtime command — it's giving "quick intro, don't expect a novel" energy, and honestly? valid.

bbtime displays the time in a small blackbox style window. that's the whole gig. she's a clock, she's cute, she matches your blackbox aesthetic. main character energy fr fr 💅

---

💅 OPTIONS 💅

here's the summary of options, bestie. every single one, no skipping:

• -d[isplay] <displayname> — which X server to connect to 🖥️
• -c[onfig] <filename> — use an alternate config file
• -bb[config] <filename> — use an alternate Blackbox config file
• -def[ault] — fall back on the default configuration 🙈
• -m[ailbox] <filename> — the filename of the mailbox
• -v[ersion] — display version number ⭐
• -h[elp] — display this help
• -p[osition] <position> — set position of window, where <position> = [+]|[-]x[+]|[-]y
• -w[ithdrawn] — place bbtool in the Slit
• -s[hape] — don't display groundplate 🫶

ngl the brackets mean you can shorten the flag — -d works just like -display, -c just like -config, etc. that's what those [ ] are doing in there.

---

🌈 CONFIGURATION 🌈

👑 Blackbox Users:

by default bbtime reads the Blackbox style-file as defined in .blackboxrc and copies as much of the style as possible. the result? an application that looks a lot like the toolbar. iconique behavior honestly.

further configuration options can be found in bbtime.style. most likely you want to change these options, so copy this file to somewhere in your homedir (eg blackbox/bbtime.config) and edit it. then edit the file .blackboxrc and add or edit the line:

bbtime.configFile: <your config file>

WARNING: You have to define the entire PATH. 🚨 like, the WHOLE thing. do not skimp.

all style options set by reading the Blackbox-style file can be overridden by placing them in bbtime.config (and changing them). see bbtime.style for all possible options.

make sure the file .bbtoolsrc does not exist, else the configuration style for other Window Managers will be used. 😭

🧚 Users of other Window managers:

by default bbtime reads the bbtoolsrc and bbtime.nobb config files. if you want to define your personal config-file, copy bbtoolsrc to your homedir as ./.bbtoolsrc. copy bbtime.nobb somewhere in your homedir. then edit .bbtoolsrc and add or edit the line:

bbtime.configFile: <your config file>

WARNING: You have to define the entire PATH. (yes again. it's serious. 💀)

🍓 Reconfiguration

press the right mouse-button on the envelope to cause bbtime to re-read its settings. that's it. that's the whole ritual. slay. ✨

---

💜 FILES 💜

bbtime automatically copies the style of the blackbox toolbar. It copies:

toolbar                  -> bbtime.frame
toolbar.label            -> bbtime.label
toolbar.color            -> bbtime.frame.color
toolbar.colorTo          -> bbtime.frame.colorTo
toolbar.label.color      -> bbtime.label.color
toolbar.label.colorTo    -> bbtime.label.colorTo
toolbar.textColor        -> bbtime.textColor
bevelWidth               -> bbtime.bevelWidth

WARNING: if .bbtoolsrc is defined it won't copy the blackbox style. 🙈

for the meaning of the different resources see the comments in the config-files. the answers are literally right there, bestie, read the comments.

---

⭐ SEE ALSO ⭐

bbdate(1), bbppp(1) — go give them a look, they're the siblings 🫶

---

🌸 AUTHOR 🌸

this manual page was written by Chris Tillman <tillman@azstarnet.com> for the Debian GNU/Linux system (but may be used by others). absolute legend behavior, we love a documented manpage 👑

---

and that's the whole page!! this one's from December 29 2001, BBTIME(1), part of the General Commands Manual — so yeah, she's been serving time-display realness since the early 2000s and she's still iconic for it. periodt. 💖✨🦋