Drop-down terminal for GNOME
Go to file
Olaf Lessenich 1c18e87423 Fix window position drift during visibility toggles
Defer window positioning using queue_resize() and GLib.idle_add() to ensure
all widget layout calculations are complete before moving the window.

Fixes #2184

sem-ver: bugfix
2025-09-05 18:55:08 +08:00
.github Adjust CI dependency installs and parameters 2025-01-07 13:38:21 +08:00
docs Use pipenv builtin requirements instead of pipenv-to-requirements 2025-01-04 19:13:24 +08:00
guake Fix window position drift during visibility toggles 2025-09-05 18:55:08 +08:00
po update hu language 2024-05-28 22:08:28 +08:00
releasenotes Fix window position drift during visibility toggles 2025-09-05 18:55:08 +08:00
scripts Adjust CI dependency installs and parameters 2025-01-07 13:38:21 +08:00
.deepsource.toml Add .deepsource.toml 2021-09-10 10:26:18 +02:00
.editorconfig Add upload to test-pipy and pipy (on tags) 2021-09-22 10:38:22 +02:00
.flake8 Update linters 2025-01-04 19:13:24 +08:00
.gitignore chore: update PO 2022-01-18 22:14:48 +01:00
.pep8rc Use pipenv, pbr 2017-10-19 17:57:37 +02:00
.pre-commit-config.yaml Add pre-commit config and apply all fixes 2022-10-27 15:31:25 +08:00
.pylintrc Update linters 2025-01-04 19:13:24 +08:00
COPYING Fixing file permissions (chmod -x) 2008-04-21 21:48:27 -03:00
MAINTAINERS Split maintainers from original author 2020-03-09 14:18:09 +01:00
Makefile Use pipenv builtin requirements instead of pipenv-to-requirements 2025-01-04 19:13:24 +08:00
MANIFEST.in Add pre-commit config and apply all fixes 2022-10-27 15:31:25 +08:00
NEWS.rst doc: release notes for 3.8.5 2022-02-06 21:04:21 +01:00
Pipfile Bump versions and fix CI 2025-01-04 19:13:24 +08:00
Pipfile.lock Bump versions and fix CI 2025-01-04 19:13:24 +08:00
pyproject.toml Replace autopep8, yapf by black 2020-02-18 22:58:54 +01:00
README.rst docs: update website URLs, use https:// 2024-04-05 21:32:50 +02:00
requirements-dev.txt Bump versions and fix CI 2025-01-04 19:13:24 +08:00
requirements.txt Bump versions and fix CI 2025-01-04 19:13:24 +08:00
setup.cfg Bump CI versions 2023-02-14 07:17:07 +08:00
setup.py Fix upload to pypi test 2022-01-13 16:00:17 +08:00

==============
Guake 3 README
==============

|actions-badge|_ |bountysource-badge|_ |docs-badge|_ |translation-badge|_

.. |actions-badge| image:: https://github.com/Guake/guake/actions/workflows/ci.yml/badge.svg
.. _actions-badge: https://github.com/Guake/guake/actions

.. |bountysource-badge| image:: https://img.shields.io/bountysource/team/guake/activity.svg
.. _bountysource-badge: https://www.bountysource.com/teams/guake

.. |docs-badge| image:: https://readthedocs.org/projects/guake/badge/?version=stable
.. _docs-badge: https://guake.readthedocs.io/en/stable/?badge=stable

.. |translation-badge| image:: https://hosted.weblate.org/widgets/guake/-/guake/svg-badge.svg
.. _translation-badge: https://hosted.weblate.org/projects/guake/guake/

Introduction
============

Guake is a python based 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.

Quick Installation Guide
------------------------

Please refer to `Installation Guide <https://guake.readthedocs.io/en/latest/user/installing.html#system-wide-installation>`_

What it looks like ?
--------------------

.. image:: https://i.ibb.co/s97cJWZ/guake.png
    :alt: Guake Screenshot
    :class: with-shadow

Drop down terminal on pressing <F12>

Note when compiling from source
-------------------------------

Do **NOT** use the Tarball packages automatically generated by GitHub on the Release pages. They
won't work because one of the main components of Guake build system, PBR, requires the full Git
history to be available when building from source. Note this does not impact source distribution
packages you can download from Pypi.

Build from sources instructions are described on
`this page of the Online Documentation <http://guake.readthedocs.io/en/latest/user/installing.html#install-from-source>`_.
Please read this carefully before opening an issue!

Bugs? Information?
------------------

- Source Code available on `GitHub <https://github.com/Guake/guake/>`_.
- Official Homepage: https://guake.github.io
- Online Documentation is hosted on `ReadTheDocs <http://guake.readthedocs.io/>`_.
- If you are not a developer, you can still contribute to Guake by
  `improving its translations in your language <https://hosted.weblate.org/projects/guake/guake/>`_.
  Guake users are welcome `to support Weblate <https://weblate.org/donate/>`_ in providing this
  service for free for OpenSource Projects.

**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 project was originally created by Gabriel Falcão, see: https://sourceforge.net/projects/guake-gnome-vte/