A run utility featuring a slim design and bash-style autocompletion
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
wdlkmpx f3ff2c62eb update gmrun.1 1 year ago
data update gmrun.1 1 year ago
src main.c (gtk3.4+): G_APPLICATION_NON_UNIQUE 2 years ago
.gitignore update autogen.sh 2 years ago
AUTHORS gmrun 1.1w 1 year ago
ChangeLog gmrun 1.1w 1 year ago
LICENSE renamed: COPYING -> LICENSE 2 years ago
Makefile.am move gmrunrc & zrelease to data/ dir 2 years ago
README.md update README 2 years ago
autogen.sh merge data/zrelease into autogen.sh .. 1 year ago
configure.ac gmrun 1.1w 1 year ago



A run utiliy featuring a slim design and bash style auto-completion.


* Tilda completion (~/ <==> $HOME/)

* Completion works for separate words (e.g. you can type em<TAB> which
  turns to emacs, type a SPACE, and write the file you want to open using

* Configuration file: ~/.gmrunrc or /etc/gmrunrc.
  Check one of them, configuration is very simple. From that file you
  can change window position and width, history size, terminal, URL
  handlers, etc.

* CTRL-Enter runs the command in a terminal.
* CTRL-Enter without any command starts a new terminal.

* History is maintained in the file "~/.gmrun_history".

* CTRL-R to search backwards through history.
* CTRL-S to search forward through history.
* "!" enters a special search mode, matching only the start of strings.
-- Esc to cancel search (only once).
-- CTRL-G to cancel search and clear the text entry

* URL handlers allowing you to enter lines like "http://www.google.com"
  to start your favorite browser on www.google.com.
  The URL-s are configurable from the configuration file.

* Extension handlers.  Basically you can run, for instance,
  a ".txt" file, assuming that you have configured a handler for it
  in the configuration file.


* GTK 2/3

Compilation, installation

Use the configure script (run ./autogen.sh if ./configure is missing):

    ./configure --prefix=/usr --sysconfdir=/etc
    make install

By default it will use the GTK3 ui if it's available.

Pass `--enable-gtk2` to `./configure` to build the gtk2 ui

Optionally you can configure your window manager to call gmrun
with WinKey + R or something.

Tips and tricks

  1. Everything that doesn't start with "/" or "~" gets completed from $PATH environment var. More exactly, all files from $PATH directories are subjects to completion.

    Pressing TAB once when no text is entered opens the completion window, which will contain ALL files under $PATH.

  2. For instance you use TAB to complete from "nets" to "netscape-navigator". A small window appears, allowing you to select from:

    - netscape
    - netscape-navigator
    - netstat

    That is because all these executables have the same prefix, "nets".

    You can use UP / DOWN arrows to select the right completion. You can use CTRL-P / CTRL-N or TAB to select the right completion.

    • ESC closes the completion window, leaving the selected text in the entry.
    • HOME / END - the same, but clears the selection.
    • SPACE - the same, but clears the selection and appends one space.
    • Pressing ENTER (anytime) runs the command that is written in the entry.
    • Pressing CTRL+Enter (anytime) runs the command in a terminal (check your configuration file). But if the entry is empty (no text is present, or only whitespaces) then a fresh terminal will be started.