91 lines
3.0 KiB
Markdown
91 lines
3.0 KiB
Markdown
GMRUN
|
|
-----
|
|
A run utiliy featuring a slim design and bash style auto-completion.
|
|
|
|
Features
|
|
---------
|
|
|
|
* 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
|
|
completion).
|
|
|
|
* 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.
|
|
|
|
|
|
Requirements
|
|
-------------
|
|
|
|
* GTK 2/3
|
|
|
|
|
|
Compilation, installation
|
|
--------------------------
|
|
|
|
Use the configure script (run ./autogen.sh if ./configure is missing):
|
|
|
|
./configure --prefix=/usr --sysconfdir=/etc
|
|
make
|
|
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.
|
|
|
|
3. - 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.
|