FBRUN(1)                        Fluxbox Manual                        FBRUN(1)

NAME
       fbrun - display run dialog window

SYNOPSIS
       fbrun [options]

DESCRIPTION
       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
           Window position in pixels

       -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

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

AUTHORS
       This manpage was originally written by Bastian Kleineidam <calvin at
       debian.org> for the Debian distribution of fluxbox (but may be used by
       others).

       It was then converted to asciidoc format by Jim Ramsay <i.am at
       jimramsay.com> for fluxbox-1.1.2

SEE ALSO
       fluxbox(1)

AUTHOR
       Jim Ramsay <i.am@jimramsay.com>
           Author.

fbrun.txt                      08 February 2015                       FBRUN(1)