Gmrun is an application launcher installed by default in CrunchBang, commands typed in will be run, as in a terminal. It is accessible from the menu under Run Program (at the top), and is also attached to the key sequence Alt-F2.
apps can just be typed in and run by pressing enter. Terminal apps can be run by using ctrl-enter. Entering ctrl-enter with a blank input box will open up a blank terminal.
Gmrun features tab completion, entering tab will bring up a scrollable list of possible matches.
The same goes for email addresses, using the 'mailto:' prefix eg mailto:firstname.lastname@example.org, will launch your email client.
More shortcuts can be added to ~/.gmrun (covered below)
You can enter search mode by entering '!' as the first letter, the title should change from 'Run program' to 'Search', letters you input will then automatically come up with suggestions from your command history.
If an extension has been defined in the configuration file, files can be launched by the correct program just by typing the file name.
Press [ESC] (escape) to exit, without running anything.
For more info see the man page; in a terminal type:
or in the menu under Preferences → gmrun config → man page.
to configuration file is situated in ~/.gmrun, also accessible in the menu under Preferences → gmrun config → edit config file.
Please note that '%u' is expanded to the full command entered, '%s' is the last part after the shortcut, eg 'http://www.google.co.uk', %u would expand to 'http://www.google.co.uk', %s would expand to '//www.google.co.uk'.
ShowDotFiles = 1
TabTimeout = 0
Terminal = terminator
TermExec = terminator --command
URL_http = firefox '%u'
URL_mailto = claws-mail '%s'
EXT:html = firefox file://%s
Top = 10
Left = 10
Width = 100
History = 100
'ShowDotFiles' Whether to show dotfiles eg .gmrun in the autocomplete menu, 1 = true, 0 = false.
'TabTimeout' Whether to show the tab complete menu automatically when something is inputted, 1 = true, 0 = false.
'Terminal' The command to run when Ctrl-enter is entered without other input.
'TermExec' The command to run when running a specific command in the terminal eg 'ls ~ (Ctrl-enter)'.
_http' The command to run when a web address is entered.
_mailto' The command to run when an email address is entered.
'EXT:html' command to open html files with, based on the file extension, another might be 'EXT:txt = gedit %s'
'Top' & 'Left' The placement of the window, in pixels from the respective edge.
'Width' The width in pixels of the window.
'History' Length of command history that is stored.
Shortcuts can easily be added.
URL_cb = firefox 'http://www.google.com/cse?cx=partner-pub-3417583613261068%3A7tth0pjc0lw&q=%s'
Which is used like this:
Would search CrunchBang forums for 'Help!'.