Skip to content

Releases

Quake Windows 2.2.1

Choose a tag to compare

@coordinatio coordinatio released this 29 Oct 08:44

Make any window behave like a quake-style terminal: a global shortcut shows and hides it.
Seven slots, each selected by a regular expression on the window title.

Requires KWin 6 (Plasma 6). The previous release, v1.2, targeted KWin 5, so this one is
installed rather than upgraded in place.

Install

kpackagetool6 --type KWin/Script --install quakewindows_v2.2.1.kwinscript

Then enable Quake Windows in System Settings → Window Management → KWin Scripts and press
Configure to fill in the slots. To update an existing installation use
kpackagetool6 --type KWin/Script --upgrade quakewindows_v2.2.1.kwinscript and re-enable the
script.

The archive carries contents/, LICENSE and metadata.json only: tests/, po/ and the
build scripts stay out of it because it is assembled by ./pack.sh, which is also what the
release checks run.

Changes since v1.2

  • Native settings dialog — seven slots, each an enable checkbox plus a window-title
    regular expression, with Defaults. No more hand-editing kwinrc. The dialog ships in
    English and Russian.
  • Live configuration reload — Apply is picked up without disabling and re-enabling the
    script. A press that arrives while a settings window is focused is deferred and replayed
    once the configuration is fresh, through the scripting interface's reply or
    options.configChanged.
  • No lost presses — if KWin never answers the reload request, the script falls back once
    to org.kde.KWin.reconfigure, writes a single journal line and replays the press anyway.
  • Journal reporting — QuakeWindows: lines in
    journalctl -f -u plasma-kwin_wayland explain what the script decided, including ignored
    invalid expressions.
  • Russian translation of the dialog and of the package metadata.
  • Tests and CI — the script logic, the settings form, the committed catalogs and the
    dialog wiring are covered by dependency-free node/python3 suites plus optional Qt/KWin
    checks, run on every push.

Matching rules

  • Expressions are JavaScript regular expressions and are matched case-sensitively anywhere in
    the window title — anchor them with ^…$ when the whole title has to match.
  • An empty slot is inactive, and matching requires a non-empty window caption.
  • An invalid expression is ignored and reported in the journal; the other slots keep working.
  • Windows are toggled with Toggle Window 1 … Toggle Window 7 in System Settings →
    Keyboard → Shortcuts → KWin
    ; the shortcut identifiers are unchanged since the earlier
    releases.

Upgrading

Existing WindowName1 … WindowName7 values and existing global shortcuts are preserved.
Two behaviour changes since 2.1: an empty slot no longer falls back to the expression
Alacritty (enter it explicitly if you relied on that), and a catch-all pattern such as .*
no longer matches caption-less windows.

Setting expressions by hand remains supported: the script reads the [Script-quakewindows]
group of kwinrc, so kwriteconfig6 still works. A hand-made change still needs the
configuration dialog to be reopened and applied, or the script disabled and re-enabled.

Release archive

quakewindows_v2.2.1.kwinscript, 30 323 bytes, built from this tag with ./pack.sh:

SHA-256  8601542bf44fe0d0c71ac4603237c3f06e56644bbe59cda64da1c8562eeab0c9

The initial public release

Choose a tag to compare

@coordinatio coordinatio released this 22 Oct 13:31
v1.2

Better project description