guake-indicator(1)

πŸ’… guake-indicator β€” the manual page, but make it cute

okay so bestie, welcome to guake-indicator(1), straight outta the General Commands Manual. sit down, grab a strawberry, we're gonna learn a whole lil app together ✨


πŸŽ€ NAME πŸŽ€

guake-indicator β€” a simple Appindicator that lets you send custom commands to Guake. that's it, that's the whole vibe. no cap.


🌸 SYNOPSIS 🌸

guake-indicator

no flags, no arguments, no drama. just run it. periodt πŸ’…


πŸ¦‹ DESCRIPTION πŸ¦‹

so here's the tea: guake-indicator lets you manage all your favorite customized commands by establishing a new connection with Guake dropdown terminal. your lil command collection, but make it accessible.

it sticks to your "System Tray" (iconic behavior, honestly) and displays data it retrieved from the Guake indicator configuration file β€” peep the FILES section below for the deets πŸ‘€


✨ FILES ✨

guake-indicator builds its whole menu according to the ~/.guake.indicator/guake-indicator.xml XML file. that's the blueprint, bestie.

and if that config file doesn't exist yet? no worries β€” a default one will be created for you 🫢

now, Guake indicator does have a built-in menu editor, which is very slay of it. but you can also just customize the file however you want with your favorite text editor β€” use this schema as a base to add new entries. the fields are pretty self-explanatory, but here's the in-depth rundown of each one, because I love you and I want you to thrive:

  • menu_name β€” the name that will show up in the indicator itself. this is the one doing the main character energy.
  • tab_name β€” the name of the guake terminal tab once it is opened. leave it blank if you don't want automatic autorenaming. (the original doc says "leave black" and honestly πŸ’€ we all knew what she meant.)
  • command_after_login β€” the command to send to Guake through his DBUS interface. this is the actual payload, the moment we've all been waiting for.
  • dont_show_guake β€” if set to yes, Guake indicator won't ask Guake to display his main window. lowkey introvert mode.
  • open_in_tab β€” the index of the Guake tab where guake-indicator will execute the command. Guake assigns index 0 to the first tab, so put in this field the nth tab-1 number. and if this tag has the attribute named="yes", it contains the name of the Guake tab.
  • lfcr β€” if set to yes, a LF (Line Feed) + CR (Carriage return) is sent to Guake after each line. by default only a line feed (ascii code 10) is sent. so like, only enable this if you actually want the extra CR, bestie, don't just turn it on for fun.
  • guakeindicatorscript β€” if set to yes, enables the Guake indicator scripting function. fancy ✨
heads up! all of the above xml fields are optional (except menu_name, that one's mandatory, she's the moment) and they must be stored within an XML Host parent field, which in turn is enclosed within a HostGroup field. structure matters, okay?

you can find more information and a xsd validation file at http://guake-indicator.ozzyboshi.com 🌈


😭 BUGS 😭

found a bug? please report any bug to Alessio Garzi <gun101@email.it>. be nice, be specific, and don't @ me 🫢


πŸ‘‘ AUTHOR πŸ‘‘

guake-indicator was written by Alessio Garzi <gun101@email.it>.

this manual page was written by Alessio Garzi <gun101@email.it> too. one person, two jobs, absolute icon behavior πŸ’…


and that's the whole page, bestie πŸŽ€ you just read guake-indicator(1) from the General Commands Manual β€” go forth, configure your tray, and slay. byeee πŸ’–βœ¨πŸ¦‹πŸŒΈ