gmrun(1.2w)

🌸 gmrun(1.2w) 🌸

okay so bestie, welcome to the gmrun(1.2w) manual page. It's giving "tiny launcher, huge main character energy," and we're gonna go through every bit of it. No cap, no skips.

✨ NAME ✨

gmrun β€” Featureful CLI-like GTK+ application launcher. That's the name and the whole vibe, periodt.

πŸš€ SYNOPSIS πŸš€

gmrun [TEXT]

Optional TEXT? Yep, that's the whole synopsis.

πŸ’– DESCRIPTION πŸ’–

gmrun is a GTK program that allows a user to use a CLI-like interface to launch applications. Literally a cute little command-line-ish launcher, but make it GUI. Obsessed.

πŸŽ€ OPTIONS πŸŽ€

If gmrun is invoked with a command-line parameter, that will be the initial content of the dialog box. So your [TEXT] walks right in and sits in the box, iconic.

You can customize gmrun using a configuration file, ~/.gmrunrc. The system-wide configuration file is /etc/gmrunrc.

The format of the configuration file is simple; variable = value.

Example:

variable1 = foobar

Now the options, one by one, because we do not leave details behind:

  • Terminal β€” the command to run when Ctrl+Enter is pressed with no command entered; used to start a new terminal.
  • TermExec β€” the command to run when Ctrl+Enter is pressed with a command entered. The entered command is supplied as an argument to TermExec.
  • Geometry β€” see /etc/gmrunrc for more info.
  • History β€” number of entered commands which should be kept in gmrun's history (~/.gmrun_history). Using the Up and Down arrow keys within the gmrun window will cycle through the history. You can search backwards through the history with Ctrl+R, and forward with Ctrl+S. Hit "!" to enter a special search that matches only the start of strings. To cancel a search, hit the ESC key. Otherwise, after you have found the history item you wish to run, hit Enter. Also: CTRL-P = Up / CTRL-N = Down.
  • ShowLast β€” whether to show the last command as initial text, or an empty textarea (1 or 0).
  • Selected β€” whether the initial text should be selected or not (1 or 0).

πŸ”— URL/File HANDLING πŸ”—

  • USE_GLIB_XDG = 1 β€” for automatic URL and File handling using the freedesktop specification.

See /etc/gmrunrc for custom URL and extension handlers (USE_GLIB_XDG = 0).

The included configuration files have a few examples which you can work with. You should also note that the protocol part of URL_protocol can be anything. You can set up "URL_foobarbazcustom", and so long as you enter in "foobarbazcustom:<whatever>", it will use the given program.

πŸ‘€ SEE ALSO πŸ‘€

  • /etc/gmrunrc.

πŸ‘‘ AUTHOR πŸ‘‘

Originally written by Mihai Bazon , the latest version is available from https://github.com/wdlkmpx/gmrun/.

This manual page was originally written by David B Harris <david@eelf.ddts.net>.


and that's the whole manual, bestie. This page is from 2021, and it's the gmrun(1.2w) manual β€” mwah πŸ’‹βœ¨

πŸ“¦ where this page comes from