Drop-down terminal for GNOME
Python Shell M4 Other
Latest commit a183b05 Jan 31, 2017 @Stibbons Stibbons committed on GitHub Merge pull request #903 from TheKevJames/patch-1
fix formatting of Fedora install directives
Failed to load latest commit information.
data-gtk3 New installation scripts and initial dconf handler Aug 24, 2015
data Update guake.glade Jan 30, 2017
doc doc conf now use @VERSION@ Nov 23, 2014
git-hooks import python validate scripts and git hooks from the buildbot project Feb 11, 2014
m4 Revert "fix: Install to /usr instead of /usr/local" Aug 8, 2014
po Update pt_BR.po Jan 22, 2017
src-gtk3/guake Pep8 fixes Dec 29, 2015
src Merge pull request #896 from brandoncurtis/master Jan 30, 2017
.gitignore #793 tests & code have been updated Dec 8, 2016
.travis.yml #793 unittests have been disabled Dec 9, 2016
AUTHORS Add myself in AUTHORS Feb 11, 2014
COPYING Fixing file permissions (chmod -x) Apr 22, 2008
ChangeLog Changelog redirects to NEWS Feb 12, 2014
INSTALL Update INSTALL Sep 11, 2015
Makefile.am guake = src/guake propagation to build system Nov 22, 2014
NEWS Prepare for 0.8.8 release Nov 28, 2016
README.rst fix formatting of Fedora install directives Jan 30, 2017
autogen.sh fix autogen.sh with new sources path Nov 22, 2014
configure.ac Update change news Nov 28, 2016
dev-gtk3.sh New installation scripts and initial dconf handler Aug 24, 2015
dev.sh #793 shell scripts updated Dec 8, 2016
fiximports.py another fix Dec 29, 2015
install-lib.py Fix Guake cannot restore from fullscreen #628 Oct 16, 2015
install.py max line lenght is really 100 Sep 22, 2015
pep8rc max line lenght is really 100 Sep 22, 2015
pylintrc Fix pylint consider-iterating-dictionary Nov 28, 2016
python-requirements.in #793 test requirements returned back [skip ci] Dec 9, 2016
python-requirements.txt #803: added params to the dev.sh Aug 24, 2016
run_tests.sh updated tests Dec 9, 2016
validate.sh Old Pylint actually works with Travis Jun 6, 2016


Guake README file



Guake is a dropdown terminal made for the GNOME desktop environment. Guake's style of window is based on an FPS game, and one of its goals is to be easy to reach.

Guake is mostly written in Python and has a little piece in C (https://github.com/engla/keybinder). The source code is placed in the guake directory. Files and images are in the data directory. Translation files are in the po directory.


  • Lightweight
  • Simple Easy and Elegant
  • Smooth integration of terminal into GUI
  • Appears when you call and disappears once you are done by pressing a predefined hotkey (F12 by default)
  • Compiz transparency support
  • Multi tab
  • Plenty of color palettes
  • Quick Open in your favorite text editor with a click on a file name (with line number support)
  • Customizable hotkeys for tab access, reorganization, background transparency, font size,...
  • Extremely configurable
  • Configure Guake startup by running a bash script when Guake starts
  • Multi-monitor support (open on a specified monitor, open on mouse monitor)
  • Save terminal content to file
  • Open URL to your browser

Bugs? Information?

Source Code available at: https://github.com/Guake/guake/

Official Homepage: http://guake-project.org

Important note: Do NOT use the domain guake.org, it has been registered by someone outside the team. We cannot be held responsible for the content on that web site.


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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.


  • Python2.7+
  • pygtk2.10 (gtk.StatusIcon)
  • notify-osd (ubuntu)
  • python-appindicator (ubuntu)
  • python-dbus
  • python-gconf
  • python-keybinder
  • python-notify
  • python-vte
  • python-xdg
  • libutempter

To build guake, you will need the following packages too:

  • python-dev
  • gtk+-2.0-dev
  • pygtk-dev
  • gconf2-dev (to use some autoconf stuff)

For Python 3, you need this package too:

  • python3-dev

To edit the glade file, you can use the glade editor. Ensure to use the gtk-2 version:

  • glade-gtk2

To have beautiful color logs when you debug Guake, install colorlog, so you'll have great logs in the terminal that launched Guake!

  • pip install colorlog



Execute the following command to install guake with all default options:

$ ./dev.sh --install

It will install all dependencies, compiles and install all files to /usr/local.


Use the following command to start guake without installing it (you need to have installed it at least once):

$ ./dev.sh


An external, unofficial PPA for latest version of Ubuntu seems to integrate Guake regularly. Check it at the following URL:



Under Debian/Ubuntu, make sure you have source code repositories enabled, then the following command should install all the build dependencies:

sudo apt-get build-dep guake

For compiling from these sources, please install the following packages (Ubuntu 13.10):

sudo apt-get install build-essential python autoconf
sudo apt-get install gnome-common gtk-doc-tools libglib2.0-dev libgtk2.0-dev
sudo apt-get install python-gtk2 python-gtk2-dev python-vte glade python-glade2
sudo apt-get install libgconf2-dev python-appindicator
sudo apt-get install python-vte python-gconf python-keybinder
sudo apt-get install notify-osd
sudo apt-get install libutempter0
sudo apt-get install python-notify
# uncomment for Python 3
# sudo apt-get install python3-dev
# uncomment for glade Gtk-2 editor
# sudo apt-get install glade-gtk2


Guake is available in the official repositories:

sudo yum install guake    # for Fedora 19 - 21
sudo dnf install guake    # for Fedora 23 and above

If compiling from source, please install dependencies:

sudo dnf builddep guake


Guake can be found in the official repositories and installed by running:

sudo pacman -S guake

For compiling from these sources, please install the following packages (for Python 2):

gnome-common python2-gconf python2-xdg

To run Guake with Python 2, use the trick described in Arch Wiki and put this as your /usr/local/bin/python (changing /path/to/guake into a real path where you cloned the repository):

script=$(readlink -f -- "$1")
case "$script" in (/path/to/guake*)
    exec python2 "$@"

exec python3 "$@"

Make it executable with chmod +x /usr/local/bin/python.


We are using an autotools based installation, so if you got the source of guake from a release tarball, please do the following:

$ git clone https://github.com/Guake/guake.git
$ cd guake
$ ./autogen.sh && ./configure && make

For Ubuntu user, we have a script that does all these steps for you. Use:

$ ./dev.sh

Testing as an unprivileged user

To run Guake as an unprivileged user for testing purposes, after make continue with:

$ gconftool-2 --install-schema-file=data/guake.schemas
$ PYTHONPATH=src python src/guake/main.py

Note: Ubuntu users, you can use the following command:

$ ./dev.sh

System-wide installation

To install Guake to all users, after make continue with:

$ sudo make install

If you receive a message asking you if you have installed guake.schemas properly when launching guake, it means that your default sysconfdir is different from the one chosen by autotools. To fix that, you probably have to append the param --sysconfdir=/etc to your ./configure call, like this:

$ ./configure --sysconfdir=/etc && make

If it is not enough you can install the gconf schemas file by hand by doing the following:

$ GCONF_CONFIG_SOURCE="" gconftool-2 --makefile-install-rule data/guake.schemas

For more install details, please read the INSTALL file.


Upate translation

First update all translation files:

$ cd po
$ make update-po

Then use your favorite po editor, such as poedit.

Once finished, compile your result with:

$ cd po
$ make

Git hook

Please install this git hook if you want to beautify your patch before submission:

$ cd guake
$ ln -s git-hooks/post-commit .git/hooks/

Validate your code

We are strict on code styling, with pep8 and pylint running automatically in travis in order to reject badly shaped patches. Please use the following command to validate all python files:

$ ./validate.sh

Update NEWS

Add your change in the NEWS file. The ChangeLog files is not more used.

New version

To start development on a new version:

  • update configure.ac:

    AC_INIT([guake], [0.x.y], [http://guake-project.org/])
  • add a new section in the NEWS file

When read, create a new release on the github site.

Travis build

Travis automatically check pull requests are compiling and check for code style.

Status of the master branch: https://travis-ci.org/Guake/guake.png?branch=master