Installation

NOTE: Please enable configuration after installing the script for the best user experience

Using KDE Add-On Installer

KDE provides a built-in manager for various KDE extensions, which supports downloading from KDE store.

1. Open System Settings > Window Management > KWin Scripts
   • Alternatively, you can type "KWin Script" into Application Launcher or KRunner(Alt-F2) to directly open the dialog
2. Click Get New Scripts... button to open the add-on installer
3. Search "krohnkite", and wait for search result
4. Click Install (or Update)

If you're upgrading Krohnkite, you will have to re-login or restart KWin to clean up its internal script cache.

Through .kwinscript package file

You can obtain krohnkite-*.kwinscript package file from KDE store page, Github Releases pages or by compiling. This file can be installed through KWin Scripts dialog.

1. Open System Settings > Window Management > KWin Scripts
   • Alternatively, you can type "KWin Script" into Application Launcher or KRunner(Alt-F2) to directly open the dialog
2. Press Install from File... (or Import KWin script...) button.
3. Select the package file, and press Open

Krohnkite should be visible in the list of scripts. If you don't, try reopening the KWin Scripts dialog.

Alternatively, you can install the package through command-line:

plasmapkg2 -t kwinscript -i /path/to/krohnkite.kwinscript # installing new script
plasmapkg2 -t kwinscript -u /path/to/krohnkite.kwinscript # upgrading existing script

To uninstall the package:

plasmapkg2 -t kwinscript -r krohnkite

Installing from Git repository

Krohnkite Makefile provides install/uninstall targets. To perform installation (and uninstallation) run the following commands in the cloned git directory:

make install
make uninstall

make will automatically build and create kwinscript package, and install it to your account.

You can also choose to only build the kwinscript package file:

make package

Running without installing

If you have the source code, you can temporarily load Krohnkite without installing it. Its makefile provides targets for this:

make run
make stop

Note that Krohnkite destroys itself cleanly once disabled, so no restart is required to deactivated it.

Enable Script Configuration

It is reported that a manual step is required to make KWin scripts configurable. This is a limitation of KDE/KWin.

To enable configuration, you must run the following in command-line:

mkdir -pv ~/.local/share/kservices5/
ln -sv ~/.local/share/kwin/scripts/krohnkite/metadata.desktop ~/.local/share/kservices5/krohnkite.desktop

After this, a configuration button should appear for Krohnkite in KWin Scripts dialog.

IMPORTANT: Whenever Krohnkite settings are changed, you must restart the script:

1. From KWin Scripts dialog, untick Krohnkite
2. Apply
3. tick Krohnkite
4. Apply

Or, you can choose to simply restart KWin, which is a brutal, but can be done through command-line:

kwin_x11 --replace &