KeyProfile Bridge

Automatic Wooting profile switching for KDE Plasma 6 on Wayland.

KeyProfile Bridge reads the active window from KWin, matches it to the app links configured in Wootility, and switches the keyboard profile directly. It is a temporary compatibility solution until Wootility supports reliable App Linking on this platform.

KeyProfile Bridge is used alongside the original Wootility software, not as a replacement. Wootility can still be used normally to create, edit, and manage profiles; KeyProfile Bridge only adds the automatic profile switching that currently does not work reliably on KDE Plasma Wayland.

Warning

Unofficial community project. Not affiliated with, endorsed by, or supported by Wooting Technologies B.V. or the Wootility team. Use at your own risk.

Requirements

• KDE Plasma 6 running on Wayland
• Arch Linux or an Arch-based distribution such as CachyOS
• A supported Wooting keyboard
• Profiles and app links configured in Wootility
• Original Wootility software and Wooting Background Service installed

Required packages are installed automatically when missing.

Install or update

Run:

curl -fsSL https://raw.githubusercontent.com/apfelgriebsch/KeyProfileBridge/main/install-online.sh | bash

The same command updates an existing installation. Saved settings and Wootility profiles are preserved.

After installation, open KeyProfile Bridge from the application menu and accept the first-start notice.

Usage

1. Configure profiles and app links in Wootility.
2. Open Settings → General and enable the bridge.
3. Right-click the tray icon and select the onboard return profile P1–P4.

The P1–P4 selection defines which onboard keyboard profile is restored after an automatically linked game or program profile is no longer active. For example, when P3 is selected, KeyProfile Bridge applies the linked app profile while the game or program is active and returns to P3 when you leave it. P1 is used by default.

The tray menu also provides access to Wootility, profile reloading, settings, and quitting the bridge for the current session.

Wootility background service

The original Wooting Background Service remains part of the normal Wootility installation and is not continuously controlled by KeyProfile Bridge.

When Check Wootility background service at system startup is enabled, KeyProfile Bridge checks the service once after sign-in. If it is already running, nothing is changed. If it is not running, KeyProfile Bridge starts it.

Updates

Open Settings → Updates to:

• check for and install updates manually
• enable silent automatic updates
• enable update notifications

Automatic updates are disabled by default.

Uninstall

Use Settings → Installation → Uninstall, or run:

~/.local/lib/keyprofile-bridge/uninstall.sh

To also remove saved settings:

~/.local/lib/keyprofile-bridge/uninstall.sh --purge

Wootility profiles are never removed.

License

Released under the MIT License. See NOTICE.md for the full unofficial-project notice.