BBKEYS(1)

📦 version 0.9.0, in fedora 43, fedora 44

💅 BBKEYS — the bbkeys manual, section 1 🎀

okay so bestie, sit down, hydrate, because we're talking about bbkeys — a general XWindow keygrabber ✨ (that's the whole name line, fr fr, that's all it says, and honestly? iconic).

🌸 SYNOPSIS 🌸

bbkeys [OPTION]

that's it. that's the whole vibe. one command, one optional flag slot, go off 👑

✨ DESCRIPTION ✨

so bbkeys is the keygrabber for the blackbox window manager. like, that's its whole job and it does it gorgeously. it handles all keybindings and keyboard shortcuts for blackbox — every single one, no crumbs left 💖

the way it works is lowkey genius: it uses blackbox's Image classes for rendering its look and feel, so bbkeys will render itself to match whatever blackbox style you're using. it's giving "I don't have a look, I borrow looks, and I wear them better" 🦋

and it's highly configurable, bestie. you've got options:

  • the bbconf GUI utility 🖥️
  • the bbkeysconf GUI utility — which is now deprecated, so, like, it's still there but it's giving retired pop star 💀
  • or by hand-editting bbkeys's config file, if you're that girl 💅

🎀 USAGE 🎀

on startup, bbkeys reads $HOME/.bbkeysrc, which you can edit by hand or through bbconf or bbkeysconf 🫶

and — plot twist — this is now configurable through a command-line switch, as shown in OPTIONS. yes bestie, scroll down, it's right there 😭

🌈 OPTIONS 🌈

here's the summary of the options bbkeys supports, served fresh 🍓

  • -d or --display <display name> — use alternate config file. (default is ~/.bbkeysrc)
  • -D or --debug — print debugging information 🐛 (yes the capital D, don't come for me, that's what it says)
  • -c or --config <filename> — use alternate config file. (default is ~/.bbkeysrc)
  • -v or --version — display version number and exit
  • -h or --help — display help message
ok bestie real talk: -d/--display <display name> really does say "use alternate config file" in the page. that's not me being shady, that's just what the man page says, and I am a faithful narrator 💀 also the default for both -d and -c is ~/.bbkeysrc, same file, same energy.

🦋 FILES 🦋

  • Default: $datadir=/usr/local/share/
  • $HOME/.bbkeysrc maintains keybindings
  • See bbkeysrc(5)

⭐ VERSION ⭐

0.9.0

vintage. classic. ate. 👑

💀 BUGS 💀

okay the man page says, and I quote, that this application is perfect and should solve all of your problems, up to and including male pattern baldness and world hunger. so like. no notes. flawless. main character behavior fr fr 🙈

however — should you, against all odds, find any bugs, please report them to the author. that's the assignment, bestie, don't just suffer in silence 🫶

💜 SEE ALSO 💜

that's the one. that's the list. go read it, iykyk 📖

👑 AUTHOR 👑

  • Jason 'vanRijn' Kasper <vR@movingparts.net> — bbkeys
  • Jan Schaumann <jschauma@netmeister.org> — this man page

and that's the whole page, bestie!! this one came from vanRijn, dated August 27, 2004 — so if you're reading it, you're reading a certified classic, and honestly? slay. now go bind some keys and be your own main character 💅✨🎀

📦 where this page comes from