↑ arvau

ArchWiki / Gmrun

de:Gmrun ja:Gmrun zh-hans:Gmrun Gmrun (Gnome Completion-Run) is an lightweight application launcher similar to GNOME Run, Application Finder, KRunner, etc.

Installation

Gmrun can be installed with the package gmrun.

Usage

  • GUI applications can just be typed in and run by pressing Enter, terminal applications can be run by using Ctrl+Enter. Pressing Ctrl+Enter with an empty input box will open up a terminal window.

  • Gmrun features tab completion: pressing tab will bring up a scrollable list of possible matches.

  • Web addresses entered into Gmrun will launch a web browser automatically.

  • The same goes for email addresses, using the mailto: prefix e.g. mailto:foo@bar.com, will launch your email client.

  • More shortcuts can be added to ~/.gmrunrc (See #Configuration below) or you can modify the system-wide file at /etc/gmrunc.

  • 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.

  • Ctrl+r will allow you to search backwards through that history.

  • Ctrl+s will search forward through the history.

  • Ctrl+g will cancel the search.

  • 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 to close Gmrun, without running anything.

Configuration

The configuration file is located at /etc/gmrunrc but you can create a per-user configuration (recommended) in ~/.gmrunrc. Please note that %u is expanded to the full command entered, %s is the last part after the shortcut (e.g. if you enter the URL https://archlinux.org, %u would keep https://archlinux.org and %s would shorten to //archlinux.org. )

Here is an example configuration file. 


# gmrun configuration file
# gmrun is (C) Mihai Bazon, <mishoo@infoiasi.ro>
# GPL v2.0 applies

# Set terminal
Terminal = urxvt
TermExec = ${Terminal} -e
AlwaysInTerm = ssh telnet ftp lynx mc vi vim pine centericq perldoc man

# Set window geometry (except height)
Width = 400
Top = 300
Left = 450

# History size
History = 256

# Shows last history line selected when invoked
ShowLast = 1

# Show files starting with '.'
# Default is 0 (off), set it to 1 if you want "hidden" files to show up
# in the completion window
ShowDotFiles = 0

# Timeout (in milliseconds) after which gmrun will simulate a TAB press
# Set this to NULL if do not like this feature.
TabTimeout = 0

# URL handlers
# If the entered text is "http://www.google.com" then:
#   - %u gets replaced with the whole URL ("http://www.google.com")
#   - %s gets replaced with "//www.google.com".  This is useful for URL-s
#     like "man:printf" --> %s will get replaced with "printf"
URL_http = firefox %u
URL_mailto = firefox -remote "mailto(%s)"
URL_man = ${TermExec} 'man %s'
URL_info = ${TermExec} 'info %s'
URL_pd = ${TermExec} 'perldoc %s'
URL_file = pcmanfm %s
URL_readme = ${TermExec} 'less /usr/doc/%s/README'
URL_info = ${TermExec} 'info %s'
URL_sh = sh -c '%s'
URL_paci = ${TermExec} 'pacman -S %s'
URL_pacs = ${TermExec} 'pacman -Ss %s'

# extension handlers
EXT:doc,rtf = AbiWord %s
EXT:txt,cc,cpp,h,java,html,htm,epl,tex,latex,js,css,xml,xsl,am,php,css,js,py,rb = gedit %s
EXT:mpeg,mpg,avi,mkv,flv = vlc %s
EXT:mp3,ogg,m4a,wmv,wma = deadbeef %s
EXT:ps = gv %s
EXT:pdf = epdfview %s
~/.gmrunrc

  1. ShowDotFiles (1 or 0): whether to show dotfiles (e.g. .gmrunrc) in the auto-complete menu.

  2. TabTimeout (1 or 0): Whether to show the tab complete menu automatically when something is inputted.

  3. Terminal: The command to run when Ctrl+Enter is pressed without other input.

  4. TermExec: The command to run when running a specific command in the terminal (e.g. ls ~).

  5. URL_http: The command to run when a web address is entered.

  6. URL_mailto: The command to run when an email address is entered.

  7. EXT:extension: The application to open files with a certain extension.

  8. Top and Left: The placement of the Gmrun window (in pixels from the respective edge).

  9. Width: The width in pixels of the window.

  10. History: Length of command history that is stored.

Adding custom shortcuts

Shortcuts can easily be added. For example, to use g as a shortcut for Google searches, add:

URL_g = firefox 'https://www.google.com/search?q=%25s'

Which is then used like this:

g:Arch

Key bindings

You can use your desktop environment's or window manager's keybinding settings to set one for Gmrun.