bbrun(1)

📦 version 1.6, in ubuntu jammy

💅 bbrun — the manual page, but make it cute

okay bestie, welcome to bbrun(1) from the bbtools collection ✨ pull up a chair, we're gonna learn a whole entire little program together 🫶

🌸 NAME 🌸

bbrun — an elegant tool for the Blackbox window manager that runs commands 💖

✨ SYNTAX ✨

bbrun [OPTIONS] [-- [-display <display>]]...

🎀 DESCRIPTION 🎀

so like, bbrun is small but it is so useful, no cap. it makes it convenient to quickly execute commands from the blackbox or fluxbox window managers. if you've ever used KDE's Alt+F2 Run Command dialog box, it's basically that vibe — bbrun is very similar to it. 💫

when you launch it, it occupies a small portion of the desktop and docks itself to the right side of the screen. to actually open the run dialog, you click on the tiny bbrun window. that's it, that's the whole interaction, iconic behavior honestly 👑

and like — you don't necessarily need blackbox for this program to work. it looks just as good in fluxbox, but heads up, it won't look the same in other window managers. so if it's looking a little off in something else, that's why, don't come for her 😭

🦋 FILES 🦋

  • ~/.bbrun_history

💜 OPTIONS 💜

  • -a, --advanced — advanced mode, bestie. it shows more options than the normal command entry box. the default is for it to be in normal (traditional/simple) mode. so if you want the extra stuff, you gotta ask for it 💅
  • -h, --help — this help screen 🫶
  • -i, --history-file=<history file> — set the history file to use. (default: ~/.bbrun_history)
  • -v, --version — print the version number 🔢
  • -w, --withdraw — withdrawn mode. it will go straight to the command entry box, no little icon pit stop, we're speedrunning 🏃♀️

options that must occur after -- if they are used:

  • -display <display> — set the display that the gearbox should show up on

🌈 GENERAL USAGE INFO 🌈

okay so here's the tea ☕ bbrun can be run in normal mode, where it creates an icon that sits in the slit. you can then click on the gear icon to make the text entry window popup. ✨

you can also run bbrun in withdrawn mode by specifying the -w flag. this is ideal for use with the key shortcut program bbkeys, because it will jump straight to the text entry screen. no clicking, no icon, just vibes. and bbrun also supports the 'escape' and 'enter' keys for those of you who like to use the mouse as little as possible 🖱️🚫 (main character energy fr fr)

bbrun keeps a history of your most recent commands. the history list is stored in the '.bbrun_history' file in your home directory. if the file does not exist, it is created automatically — she's self-sufficient, we love that 💖

⚠️ also keep in mind that you need quotes when you specify arguments with spaces in them. eg. mpg123 '/mp3/Creed - Higher.mp3'

and that's the whole thing. the way this file was updated by Kevin Coyner <kcoyner@debian.org> on February 12, 2007. periodt. 💅

with love, your girl Josh King <jking@dwave.net> — version 1.6, page bbrun(1) 🎀✨ slay, go run some commands bestie 🦋

📦 where this page comes from