NAME

       bbrun - An elegant tool for the Blackbox window manager that runs commands

SYNTAX

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

DESCRIPTION

       bbrun is a small but very useful application. It makes it convenient to quickly execute commands from the
       blackbox or fluxbox window managers. bbrun is very similar to KDE's Alt+F2 Run Command dialog  box.  When
       launched,  it  occupies  a small portion of the desktop and docks itself to the right side of the screen.
       The run dialog is opened by clicking on the tiny bbrun window.

       You don't necessarily need blackbox for this program to work. It looks just as good in  fluxbox,  but  it
       won't look the same in other window managers.

FILES

       ~/.bbrun_history

OPTIONS

       -a, --advanced - advanced mode, shows more options than the normal command entry box.  The default is for
       it to be in normal (traditional/simple) mode.

       -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, will go straight to command entry box

       Options that must occur after '--' if they are used:

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

GENERAL USAGE INFO

       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  since  it  will  jump
       straight  to  the  text entry screen.  bbrun also supports the 'escape' and 'enter' keys for those of you
       who like to use the mouse as little as possbile.

       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.

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

       This file was updated by Kevin Coyner <kcoyner@debian.org> on February 12, 2007.