Note From Me

EDIT: I'm finally attempting to update to plasma 6, so I probably won't be using this anymore. But hey, there's a Krohnkite fork for plasma 6 that is being maintained: https://github.com/anametologin/krohnkite. I suggest using that since Bismuth was originally a fork of Krohnkite so the functionality & available keybinds are very similar.

Hello, I use Bismuth on KDE5 for tiling. I am gonna maintain this fork for as long as I do use Bismuth & am stuck on KDE5, but no guarantees ofc. The latest Bismuth works fine still on X11. I am just pulling in some PRs to try and get it working on Wayland. Namely:

Btw, if you use Gentoo, here's an ebuild: https://github.com/Interpause/sh-scripts/blob/main/ebuilds/kde-misc/bismuth/bismuth-3.1.5.ebuild

🌈 Bismuth 🌈

Making tiling window management easy. On KDE Plasma.

Arrange your windows in different grids to minimize the mouse usage.

🌟 Features 🌟

Automatic window tiling

Save your time by automatically managing windows on your screen.

autotile.mp4

Plasma integration

Power-up your workflow using native Plasma features - Virtual Desktops and Activities.

workspaces.mp4

Multiple Layouts

Use different layouts in different contexts.

layouts.mp4

🏁 Getting Started

Requirements

A Linux distribution with KDE Plasma version 5.20 or higher
Qt version 5.15 or higher
KDE Frameworks version 5.78 or higher

You can check if your system matches these requirements by going to System Settings > About this System.

Installation

⚠️ Distributions' packages are not affiliated with Bismuth developers. If you encounter any issues with the incorrect installation, you should contact the package maintainer first.

Arch Linux

Debian

Volian Repository

Ubuntu

Official Repo:
```
sudo apt install kwin-bismuth
```
Volian Repository

Fedora

Official Repo:
```
sudo dnf install bismuth
```

Solus

Official Repo
```
sudo eopkg install bismuth
```

If you know a packaging solution for a distribution, that is not in the list, please open a pull request.

Usage

🎉 To start using Bismuth enable it in System Settings > Window Management > Window Tiling. Additionally, you can decorate your windows in a tiling window manager style (border-only windows) using the window decoration, that comes with Bismuth. To do so, go to System Settings > Appearance > Window Decorations and select the Bismuth decoration.

⌨️ You can view the shortcuts in System Settings > Shortcuts > Window Tiling. If you used Krohnkite before, you can import some of its shortcuts using the bash script.

🔧 If you want, you may also make a couple of manual fixes and tweaks to improve your experience with window tiling. See Tweaks section.

Configuration

You can configure Bismuth in the System Settings > Window Management > Window Tiling.

🤝 Acknowledgments

This project was made possible because of the hard work of other people on Krohnkite KWin Tiling Script.

Interpause/bismuth