jumpkwapp

Run-or-raise utility for KDE Plasma 6 / Wayland, written in Go.

Originally inspired by ww-run-or-raise and classic X11 jumpapp, this tool raises an existing window that matches your filters (class, regex, caption, desktop) or launches a command when no match is found. D-Bus messaging is handled with github.com/godbus/dbus.

Might also work on Plasma 5 / X11 with minimal adjustments.

Features

• Filter windows by exact class, class regex, or caption (case-insensitive regex).
• Restrict matches to the current virtual desktop.
• Optional toggle mode minimizes a window if it is already active.
• Optional command launches when no matching window exists.
• Automatically embeds and renders the KWin JavaScript activation logic at runtime.

Requirements

• Go 1.20 or newer.
• KDE Plasma 6 with KWin’s D-Bus scripting interface available.

Installation

Clone the repository and run/build:

go mod tidy          # fetch dependencies (godbus/dbus)
go run ./jumpkwapp.go -f firefox -c "firefox" -t --current-desktop  # run without building
go build ./jumpkwapp.go   # build
./jumpkwapp -f firefox -c firefox -t --current-desktop  # run

Usage

jumpkwapp [options]

-f,  --filter               Match window class (exact)
-fa, --filter-alternative   Match window caption (regex, case-insensitive)
-fr, --filter-regex         Match window class (regex)
-d,  --current-desktop      Only consider windows on the current desktop
-t,  --toggle               Minimize the window if it is already active
-c,  --command CMD          Launch CMD if no window matches

Examples

Raise an existing LibreWolf window on the current desktop or launch it if missing:

jumpkwapp -f librewolf -c librewolf --current-desktop

Bind the command to a global shortcut via KDE System Settings → Shortcuts.

Development

• See DEBUGGING.md for tips on querying KWin state.