Drop-down terminal for GNOME
Go to file
Gaetan Semet edd720251d ci: force version of package from the tag
Signed-off-by: Gaetan Semet <gaetan@xeberon.net>
2022-02-06 17:45:19 +01:00
.github ci: force version of package from the tag 2022-02-06 17:45:19 +01:00
docs doc: write a release procedure 2022-02-06 12:17:31 +01:00
git-hooks build: remove yapf from git-hooks 2022-02-06 12:17:31 +01:00
guake build: fix release notes generation 2022-02-06 10:52:07 +01:00
po Translated using Weblate (Turkish) 2022-02-06 12:17:31 +01:00
releasenotes build: discard old reno slugs 2022-02-06 12:17:31 +01:00
scripts setup: replace the last remnant of pbr with setuptools_scm 2021-12-20 19:09:20 +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 Setting up direnv 2021-09-10 10:38:49 +02: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
.pylintrc fix: Get CI to pass 2021-09-07 11:17:27 +02: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 build: do not generate req in github build 2022-02-06 17:45:15 +01:00
MANIFEST.in Fix translation file inclusion 2022-01-13 16:22:09 +08:00
NEWS.rst build: release notes 2022-02-06 12:17:31 +01:00
Pipfile Ran make update and updated dependencies 2021-09-21 17:46:01 +08:00
Pipfile.lock Bump pipenv from 2021.5.29 to 2022.1.8 2022-01-13 14:53:37 +08:00
pyproject.toml Replace autopep8, yapf by black 2020-02-18 22:58:54 +01:00
README.rst Fix README.rst 2021-09-30 22:43:45 +02:00
requirements-dev.txt build: fix official version computation 2022-02-06 12:17:31 +01:00
requirements.txt build: fix official version computation 2022-02-06 12:17:31 +01:00
setup.cfg Fix translation file inclusion 2022-01-13 16:22:09 +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>

Features Request
----------------

Please vote for feature on `FeatHub <http://feathub.com/Guake/guake>`_.
Open Issues on GitHub only for bug reports.

Most requested features list for Guake:

|feathub-badge|_

.. |feathub-badge| image:: http://feathub.com/Guake/guake?format=svg
.. _feathub-badge: http://feathub.com/Guake/guake

There is also a Bountysource opened here for those willing to pay a certain amount of money for a
really needed feature.
`See our Bountysource page here <https://www.bountysource.com/teams/guake>`_.

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: http://guake-project.org
- 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/