FAQ

What layouts are supported?

Right now, we have Binary Tree, Half, Three Column, Pillars, Pager, and KWin (untiled) layouts. They are highly configurable and can emulate several other layout styles.

Particularly, master-stack can be built with Half and dwindle/spiral can be built with BTree.

As Monocle is fundamentally incompatible with KWin tiles, it is unlikely that I personally will implement it. Pull requests are welcome for it.

Why use this over Krohnkite?

If Krohnkite works for you, then great! This script was made to integrate deeper with KWin, and therefore better supports features such as the virtual keyboard, tile resizing, and deep configuration. Krohnkite integrates less deeply and subsequently generally has a more predictable and stable experience.

If you would like to use Krohnkite, here is the link.

How to use the DBus saver feature?

Clone the repo and run make dbus. This requires Rust to be installed.

If you do not have Rust, download a prebuilt binary from GitHub and follow the Makefile to install it.

You can reset your settings by running polonium-saver --clear-settings.

Shortcuts are duplicated after updating!

KDE does not remove old shortcuts when updating a script. As the update renamed most of the shortcuts, you will have to remove the old ones manually. I recommend resetting them by removing all the lines in ~/.config/kglobalshortcutsrc that contain the text Polonium.

Will you add some feature I want?

Yes, probably! Open an issue or a pull request. A pull request makes it vastly more likely that a feature will be added.

It keeps breaking for me!

First run through this checklist -

  1. Make sure you have the KWin Version set to the latest you support in settings
  2. Make sure you are ignoring windows like kwin_wayland
  3. Try tweaking the rebuild delay and seeing if flickering goes anyway

Still having trouble? Open an issue here.

How about X11?

Never gonna happen. Plasma 6.8 removed it completely anyway.