/quake-terminal

Gnome Shell extesion to launch a terminal in quake mode

Primary LanguageJavaScriptGNU General Public License v3.0GPL-3.0

GNOME Shell Extension - Quake Terminal

License: GPL v3

demo.mp4

Settings

Settings

Overview

The GNOME Shell Extension - Quake Terminal enhances your desktop experience by providing a Quake-style terminal that can be summoned over any workspace with ease.

This extension offers the following features:

  • Quick Activation: You can summon the Quake Terminal using a single keyboard shortcut or a customizable key combination, ensuring fast and efficient access.
  • Workspace Integration: The Quake Terminal remains discreetly hidden in overview mode and during Alt+Tab switching, ensuring it doesn't obstruct your workspace when not in use.
  • Multi-Display Support: You have the flexibility to choose which display screen the Quake Terminal should appear on, making it even more versatile and convenient.

Future Plans

  • Adding a blur effect to the terminal actor, enhancing both aesthetics and overall appeal.

Installation

Via GNOME Extensions Website

You can easily install the extension from the GNOME Extensions website:

Get it on GNOME Extensions

Manual Installation

If you prefer manual installation, follow these steps:

  1. Clone this repository to your system:
git clone https://github.com/diegodario88/quake-terminal.git
  1. Run the provided installation script:
./scripts/install.sh

Contributing

Setup

  1. Fork this repo on github
  2. Clone your new repo
  3. Browse to the root of the project and run the provided installation script:
./scripts/install.sh
  1. Login and log back in to use the extensions
  2. Making changes in .gschema.xml requires running:
glib-compile-schemas quake-terminal@diegodario88.github.io/schemas/
  1. Repeat 3. and 4. after making code changes and 5. when necessary

Debugging

  • Watch extensions logs
journalctl -f -o cat /usr/bin/gnome-shell
  • Watch preferences window logs
journalctl -f -o cat /usr/bin/gjs
  • watch GSettings updates:
dconf watch /org/gnome/shell/extensions/quake-terminal/

GJS docs

GNOME Shell Extensions dcoumentation and tutorial: https://gjs.guide/extensions/

Like this Extension?

If you want to help me with this, consider buying me a coffee. :)

ko-fi

Made with ❤️