Difference between revisions of "Gmrun"

From ArchWiki
Jump to: navigation, search
(mostly reformatted, added some more commands here and there. gmrun seems to be REALLY unmaintained.)
m (add ja link)
 
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
[[Category:Application launchers]]
 
[[Category:Application launchers]]
 +
[[de:Gmrun]]
 +
[[ja:Gmrun]]
 
[http://sourceforge.net/projects/gmrun Gmrun] (Gnome Completion-Run) is an lightweight application launcher similar to [[GNOME]] Run, [http://docs.xfce.org/xfce/xfce4-appfinder/start Application Finder], [http://userbase.kde.org/Plasma/Krunner KRunner], etc.
 
[http://sourceforge.net/projects/gmrun Gmrun] (Gnome Completion-Run) is an lightweight application launcher similar to [[GNOME]] Run, [http://docs.xfce.org/xfce/xfce4-appfinder/start Application Finder], [http://userbase.kde.org/Plasma/Krunner KRunner], etc.
  
Line 6: Line 8:
  
 
== Usage ==
 
== Usage ==
* GUI applications can just be typed in and run by pressing enter, terminal applications can be run by using {{Keypress|Ctrl+Enter}}. Pressing {{Keypress|Ctrl+Enter}} with an empty input box will open up a terminal window.
+
* GUI applications can just be typed in and run by pressing enter, terminal applications can be run by using {{ic|Ctrl+Enter}}. Pressing {{ic|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.
 
* 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.
 
* Web addresses entered into Gmrun will launch a web browser automatically.
 
* The same goes for email addresses, using the {{ic|mailto:}} prefix e.g. {{ic|mailto:foo@bar.com}}, will launch your email client.
 
* The same goes for email addresses, using the {{ic|mailto:}} prefix e.g. {{ic|mailto:foo@bar.com}}, will launch your email client.
 
* More shortcuts can be added to {{ic|~/.gmrunrc}} (covered below) or you can modify the system-wide file at {{ic|/usr/share/gmrun/gmrunc}}.
 
* More shortcuts can be added to {{ic|~/.gmrunrc}} (covered below) or you can modify the system-wide file at {{ic|/usr/share/gmrun/gmrunc}}.
* You can enter search mode by entering {{Keypress|!}} 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.
+
* You can enter search mode by entering {{ic|!}} 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.
* {{Keypress|Ctrl-r}} will allow you to search backwards through that history.
+
* {{ic|Ctrl-r}} will allow you to search backwards through that history.
* {{Keypress|Ctrl-s}} will search forward through the history.
+
* {{ic|Ctrl-s}} will search forward through the history.
* {{Keypress|Ctrl-g}} will cancel the search.
+
* {{ic|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.
 
* 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 {{Keypress|Esc}} to close Gmrun, without running anything.
+
* Press {{ic|Esc}} to close Gmrun, without running anything.
  
 
== Configuration ==
 
== Configuration ==
The configuration file is located at {{ic|/usr/share/gmrun/gmrunrc}} but you can create a per-user configuration (recommended) in {{ic|~/.gmrunrc}}. Please note that {{ic|%u}} is expanded to the full command entered, {{ic|%s}} is the last part after the shortcut (e.g. if you enter the URL {{ic|http://www.archlinux.org}}, {{ic|%u}} would expand to {{ic|http://www.archlinux.org}} and {{ic|%s}} would expand to {{ic|//www.archlinux.org}}.  
+
The configuration file is located at {{ic|/usr/share/gmrun/gmrunrc}} but you can create a per-user configuration (recommended) in {{ic|~/.gmrunrc}}. Please note that {{ic|%u}} is expanded to the full command entered, {{ic|%s}} is the last part after the shortcut (e.g. if you enter the URL {{ic|https://www.archlinux.org}}, {{ic|%u}} would expand to {{ic|https://www.archlinux.org}} and {{ic|%s}} would expand to {{ic|//www.archlinux.org}}.  
  
 
Here is an example configuration file.
 
Here is an example configuration file.
Line 80: Line 82:
 
; ShowDotFiles (1 or 0): whether to show dotfiles (e.g. {{ic|.gmrunrc}}) in the auto-complete menu.
 
; ShowDotFiles (1 or 0): whether to show dotfiles (e.g. {{ic|.gmrunrc}}) in the auto-complete menu.
 
; TabTimeout (1 or 0): Whether to show the tab complete menu automatically when something is inputted.
 
; TabTimeout (1 or 0): Whether to show the tab complete menu automatically when something is inputted.
; Terminal: The command to run when {{Keypress|Ctrl+Enter}} is pressed without other input.
+
; Terminal: The command to run when {{ic|Ctrl+Enter}} is pressed without other input.
 
; TermExec: The command to run when running a specific command in the terminal (e.g. {{ic|ls ~}}).
 
; TermExec: The command to run when running a specific command in the terminal (e.g. {{ic|ls ~}}).
 
; URL_http: The command to run when a web address is entered.
 
; URL_http: The command to run when a web address is entered.
Line 97: Line 99:
  
 
== Key bindings ==
 
== Key bindings ==
You can use your [[Desktop_Environment|Desktop Environment]]'s or [[Window_Manager|Windows Manager]]'s keybinding settings to set one for Gmrun.
+
You can use your [[desktop environment]]'s or [[window manager]]'s keybinding settings to set one for Gmrun.

Latest revision as of 18:28, 24 August 2015

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, available in the official repositories. A multihead aware version can be installed with the gmrun-multiheadAUR package from the AUR.

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 (covered below) or you can modify the system-wide file at /usr/share/gmrun/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 /usr/share/gmrun/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://www.archlinux.org, %u would expand to https://www.archlinux.org and %s would expand to //www.archlinux.org.

Here is an example configuration file.

~/.gmrunrc
# 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
ShowDotFiles (1 or 0)
whether to show dotfiles (e.g. .gmrunrc) in the auto-complete menu.
TabTimeout (1 or 0)
Whether to show the tab complete menu automatically when something is inputted.
Terminal
The command to run when Ctrl+Enter is pressed without other input.
TermExec
The command to run when running a specific command in the terminal (e.g. ls ~).
URL_http
The command to run when a web address is entered.
URL_mailto
The command to run when an email address is entered.
EXT
extension: The application to open files with a certain extension.
Top and Left
The placement of the Gmrun window (in pixels from the respective edge).
Width
The width in pixels of the window.
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 'http://www.google.com/search?q=%s'

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.