Skip to content

diegodario88/quake-terminal

Repository files navigation

GNOME Shell Extension - Quake Terminal

License: GPL v3

demo.mp4

Settings

Settings

Sponsors

Maintenance of this project is made possible by all the contributors and sponsors. If you'd like to sponsor this project and have your avatar or company logo appear below click here. 💙

Petre TudorFlorian ReimairTiago de PaulaDavid Rodriguez

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 ❤️