GRUN(1x)

πŸ“¦ version 0.9.3+git20200303, in debian bookworm, ubuntu jammy

πŸ’– GRUN(1x) πŸ’–

okay bestie, sit DOWN, because this is the manual page for gRun, section 1x, and she is a whole mood. it's an X/GTK based application launcher. yes. that's the name. we're doing this. πŸ¦‹


✨ SYNOPSIS ✨

gRun [filename] [-v] [--version] [-h] [--help]

like. that's the whole vibe. one line. iconic. πŸ’…


🌸 DESCRIPTION 🌸

okay so gRun launches applications in X Windows without the need for an xterm session at all. no xterm. none. zero. we are FREE. πŸ•ŠοΈ

and she gives you three whole methods of launching applications, because she's generous like that:

  1. typing the command directly into the text field, main character style
  2. browsing the tree for the application, like window shopping but for programs
  3. running an application specified on the command line, for the girlies who live in the terminal

and in ALL cases β€” every single one β€” gRun exits completely after launching the application, and the application is left running as a full child of the X process, as if it were launched from a WM menu. so if you launched gRun from an xterm or a shell, the shell gets freed for further use after gRun exits. no more wasting an xterm for the duration of the application. we simply do not do that anymore. πŸ’€

ngl she's also kinda smart. gRun will attempt to complete a command automatically from the history as it is typed in, hopefully saving some time. and pressing the Tab key? it'll try to find an executable file in the path that starts with the characters you already entered into the entry box. slay. ⌨️✨

gRun also includes a facility for checking if the command is in a list of console mode apps, e.g. telnet. if it finds the command in the file, gRun launches an xterm with the command as the -e parameter. iykyk.

and now she has a facility for associating file extensions with a command, ala Windows. if an extension is found, the associated application is launched with the command entry as the parameter. she's branching out. we love to see it. πŸŽ€

πŸ› οΈ Options

  • filename β€” application name for command line launching from an xterm. the filename must exist within either the default path or have a fully qualified path. and any options passed after the filename are passed down to the application if not removed by gtk_init(). yes, if. she said what she said.
  • --persist β€” gRun dialog does not close after launching application. she stays. she lingers. she's committed. 🫢
  • --notips β€” tooltips are not displayed. no little hover-y pop-ups. minimalism era.
  • --version β€” display the current version number of grun. very demure, very mindful.
  • --help β€” display a short usage guide. we love a quick lil rundown.
bestie, heads up: gRun also recognizes all standard X Windows and GTK options, e.g. -display and -geometry. so go off. πŸŽ‰

πŸ› Bugs

None currently known.

(not a single one. she's perfect. do NOT look at her. she's flawless. πŸ˜­πŸ’–)


πŸ‘‘ AUTHOR

Bruce A. Smith <tangomanrulz@geocities.com>

the icon. the legend. the moment. 🫑


πŸ“œ COPYING

Copyright (C) 1998,1999 Bruce A. Smith <tangomanrulz@geocities.com>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

ok so genuinely β€” that warranty part is not a vibe, it's a fact. no promises, bestie. read the license. πŸ’œ

and that's the whole page, babes πŸ¦‹ gRun Version 0.9.22, dated Jan 15, 1999 β€” yeah she's a 90s girlie and she's still serving πŸ’… go launch something. bye bestie!! βœ¨πŸŒΈπŸŽ€

πŸ“¦ where this page comes from