Once installed, you can start Guake from the terminal with:
After guake has started you can right click on the interface and select Preferences to change the hotkey to drop the terminal automatically, by default it is set to
Also, you can adjust many of the Guake preferences with gconf-editor tool under apps > guake. If it's not enough for you, you are always free to copy the guake executable (
/usr/local/bin/guake and edit it in text editor, since it's just a Python script. Remember to make the file executable.
You may want Guake to load on starting up Desktop Environment. To do this, you need to
# cp /usr/share/applications/guake.desktop /etc/xdg/autostart/
See Autostarting for more info.
Like Yakuake, Guake allows to control itself at runtime by sending the D-Bus messages. Thus it can be used to start Guake in a user defined session. You can create tabs, assign names for them and also ask to run any specific command in any opened tab or just to show/hide Guake window, manually in a terminal or by creating a custom script for it.
Example of such a script is given below this section.
You can use guake executable itself to send D-Bus messages. Here is the list of available options you may be interested in:
--toggle-visibility— toggle the visibility of the terminal window. Actually, you can just type
guake, and it will toggle the visibility of already running instance.
--fullscreen— put Guake to fullscreen mode.
--show— show Guake main window.
--hide— hide Guake main window.
--new-tab=CUR_DIR— create new tab and select it. Value of
CUR_DIRused to set a current directory for the tab, if specified.
--select-tab=INDEX— select tab with index
INDEX. Tab indexes are started with 0.
--selected-tab— print index of currently selected tab.
--execute-command=CMD— execute an arbitrary command
CMDin the selected tab.
--tab-index=INDEX— used with
--rename-tabto specify index
INDEXof a tab to rename. Default value is 0.
--rename-tab=TITLE— set the tab name to
TITLE. You can reset tab title to default value by passing a single dash (
-ioption to specify which tab to rename.
--bgcolor=RGB— set the hexadecimal (
#rrggbb) background color
RGBof the selected tab.
--fgcolor=RGB— set the hexadecimal (
#rrggbb) foreground color
RGBof the selected tab.
--rename-current-tab=TITLE— same as
--rename-tab, but renames the currently selected tab.
--quit— shutdown running Guake instance.
Multiple options may be combined in a single call. If there's no guake instance running, all of the options specified will be applied to the newly created instance.
To display list of all available options, type
There are 2 ways of starting guake while applying these scripts
- copying the below example into a file like
guake-init.shmaking it executable and running that file instead of guake
- right clicking on
Guake Terminal > Preferences > Generaland adding the path to the
guake-init.shscript in the "Path to script executed on Guake start:" section while making certain to comment out
/usr/bin/guake &from the script below
The second option is preferable if you want the script to run regardless of how guake is started and you can still instruct guake not to run the script with
guake --no-startup-script if needed.
#!/bin/bash /usr/bin/guake & sleep 5 # let main guake process start and initialize D-Bus session # adjust tab which was opened by default guake --rename-tab="iotop" --execute="/usr/bin/iotop" # create new tab, start bash session in it guake --new-tab --execute="/usr/bin/bash" # and then execute htop, renaming the tab to "htop" guake --execute="/usr/bin/htop" --rename-current-tab="htop" # ... guake --new-tab --execute="/usr/bin/bash" guake --execute="/usr/bin/atop" --rename-current-tab="atop" guake --new-tab --execute="/usr/bin/bash" guake --execute="~/.iptables.sh" --rename-current-tab="iptables -nvL" guake --new-tab --execute="/usr/bin/bash" guake --execute="/usr/bin/journalctl --follow --full" --rename-current-tab="journalctl" guake --new-tab --execute="/usr/bin/bash" guake --execute="/usr/bin/irssi" --rename-current-tab="irssi" guake --new-tab --execute="/usr/bin/bash" guake --execute="/usr/bin/sudo -i" --rename-current-tab="rootshell0" guake --new-tab --execute="/usr/bin/bash" guake --execute="/usr/bin/sudo -i" --rename-current-tab="rootshell1" guake --new-tab --execute="/usr/bin/bash" guake --rename-current-tab="shell0" guake --new-tab --execute="/usr/bin/bash" guake --rename-current-tab="shell1"
Notice than we should wait some time calling sleep to avoid race conditions between running instances.
--executeoption can make harmful things on a tab running text interface program, like
innotop. Use it with caution. There is a bug on github about it: guake#921.
Using Guake on multiple monitors
There are two GConf options allowing you to change the screen on which Guake window will appear:
/apps/guake/general/display_n— display to appear on if the
mouse_displayoption is not set. If this is set to an invalid value (as in the case of removing a screen from a system), the invalid value is automatically updated to the current primary screen.
/apps/guake/general/mouse_display— appear on the mouse display. This overrides any setting in
Use some tool like gconf-editor to edit GConf options.
'Ctrl' keybind problem
Ctrl key to toggle Guake window visibility (i.e. users that setup
Ctrl+Shift+z to open the guake console are able to open it by just pressing
Shift+z, independent on whether
Ctrl key has been pressed).
To solve the problem you should manually fix the value of the GConf key
/apps/guake/keybindings/global/show_hide. Open a gconf-editor, navigate to apps > guake > keybindings > global > show_hide and replace
In Floating WM
If you are using Tilda and a floating WM, you may find out that you can use class string "Tilda" to set the window keep floating. But that Guake's WM_CLASS(STRING)'s out put is "Main.py", so you should use "Main.py" to do this. For example, in i3wm, add this to your .i3/config:
for_window [class="Main.py"] floating enable
Toggling Guake visibility does not work (Wayland)
If you are using Wayland, the Guake visibility toggle hotkey may not work under some applications. This is because Guake uses a global hotkey library made for X environments and there is no equivalent global hotkey interface for Wayland. Many applications (e.g. Firefox) run on Wayland through XWayland where the Guake toggle will work but others that natively run Wayland (e.g. GNOME apps) disable Guake toggle functionality.
If you do not wish to switch over to an X environment, a simple workaround requires configuring a shortcut with your window manager/desktop environment for the command
guake -t.The edit summary is the little text box that is found below the main editing area and just above the "Save page" button. It is very important to always write, in a succinct way, what has been done and why. Note that internal wiki links do work in edit summaries, so use them to link to any related discussions or articles; similarly, paste any urls to relevant edit diffs or external resources, such as forum threads or mailing lists.
See github issue for more details.