Scroll to navigation

gmrun(1) General Commands Manual gmrun(1)

NAME

gmrun - Featureful CLI-like GTK+ application launcher

SYNOPSIS

gmrun [TEXT]

DESCRIPTION

This manual page documents briefly the gmrun command. This manual page was written for the Debian GNU/Linux distribution because the original program does not have a manual page.

gmrun is a program that allows a user to use a CLI-like interface to launch applications from within the X11 windowing environment. It is based on the GTK+ toolkit.

OPTIONS

If gmrun is invoked with a command-line parameter, that will be the initial content of the dialog box.

gmrun can be customized both system-wide using /etc/gmrunrc and per-user in ~/.gmrunrc. Settings in the per-user configuration overwrite system-wide settings.

The format of the configuration file is simple; "variable = value". To refer to a variable as opposed to setting it, enclose the variable in ${}.

variable1 = foobar
newvariable = ${variable1} foobaz
The command to run when Ctrl+Enter is pressed with no command entered; used to start a new terminal.
The command to run when Ctrl+Enter is pressed with a command entered. The entered command is supplied as an argument to TermExec.
Initial width of gmrun window.
Initial placement of gmrun window - specify both Top and Left variables such that the gmrun window is placed at pixel (Top,Left) of your desktop.
Number of entered commands which should be kept in gmrun's history(~/.gmrun_history). Using the Up and Down arrow keys within the gmrun window will cycle through the history. You can search backwards through the history with Ctrl+R or by writing ! (exclamation mark), and forward with Ctrl+S. To cancel a search, hit Ctrl+G or the ESC key. Otherwise, after you have found the history item you wish to run, hit Enter.
Whether to show the last command as initial text, or an empty textarea (1 or 0).
Whether the initial text should be selected or not (1 or 0).

URL HANDLING

As opposed to entering a command, gmrun supports the entering of URLs. The included configuration file (/etc/gmrunrc) gives some examples. To set up your own url, create a variable in /etc/gmrunrc or ~/.gmrunrc with the format of "URL_protocol". For instance, URL_http. Here is an example:

Using this, entering "http://www.slashdot.org" will run '/usr/bin/mozilla http://slashdot.org'.
Using this, entering "mailto:david@eelf.ddts.net" will run the command 'mutt david@eelf.ddts.net'

SEE ALSO

/usr/share/doc/gmrun/README.gz, /etc/gmrunrc.

AUTHOR

gmrun was written and is maintained by Mihai Bazon <mishoo@infoiasi.ro> , the latest version is available from http://www.sourceforge.net/projects/gmrun/

This manual page was written by David B Harris <david@eelf.ddts.net>, for the Debian GNU/Linux system (but may be used by others).

August 8, 2001