Gmrunのソースを表示

[[Category:アプリケーションランチャー]]
[[en:Gmrun]]
[[de:Gmrun]]
[http://sourceforge.net/projects/gmrun Gmrun] (Gnome Completion-Run) は [[GNOME]] Run, [http://docs.xfce.org/xfce/xfce4-appfinder/start Application Finder], [http://userbase.kde.org/Plasma/Krunner KRunner] などと似ている軽量なアプリケーションランチャーです。

== インストール ==
Gmrun は[[公式リポジトリ]]の {{Pkg|gmrun}} パッケージで[[インストール]]できます。マルチディスプレイ対応版は [[AUR]] の {{AUR|gmrun-multihead}} パッケージでインストールできます。

== 使用方法 ==
* 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.
* 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.
* 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 {{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.
* {{ic|Ctrl-r}} will allow you to search backwards through that history.
* {{ic|Ctrl-s}} will search forward through the history.
* {{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.
* Press {{ic|Esc}} to close Gmrun, without running anything.

== 設定 ==
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.
{{hc|~/.gmrunrc|<nowiki>
# 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</nowiki>
}}

; 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.
; 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 ~}}).
; 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.

=== カスタムショートカットの追加 ===
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

== キーバインディング ==
[[デスクトップ環境]]や[[ウィンドウマネージャ]]のキーバインディング設定を使って Gmrun のキーバインディングを設定してください。