fbrun1

Usage

Overview

fbrun(1) is basically equivalent to the “Run...” dialog in other desktop environments. This means that it is an easy way to start a program that isn’t contained in the menu (or needs a special set of parameters for this particular invocation).

Pressing “Enter” will close the window and execute the command in your present $SHELL. Pressing “Esc” will close the window and does not execute anything.

Another way fbrun can be useful is to be called from the menu with a preloaded command line that you can edit and then execute. An example might be sshing to a very long host name with lots of options of which one changes all the time. In this case, you could add an entry for fbrun to your menu that contains all the options and the host name. When you use said entry, you could edit the line as necessary and execute it.

Options

-title title

Set title

-text text

Text input

-w width

Window width in pixels

-h height

Window height in pixels

-display display

Display name, defaults to $DISPLAY

-pos x y

-nearmouse

Position the window under the mouse cursor

-center

Position the window on the screen center

-fg color

Foreground text color. The default is black

-bg color

Background color. The default is white

-font name

Text font name

-hf filename

History file to load. The default is ~/.fluxbox/fbrun_history.

-cf filename

Completion data to load. The default is empty. If no data can be loaded, completion defaults to executables in $PATH

-preselect

Select the preset text given by the -text parameter

-autocomplete

Complete on typing. You can also set the FBRUN_AUTOCOMPLETE environment (to any value)

-help

Show this help

Examples

fbrun -fg black -bg white -text xterm -title "run xterm"