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:

• Bismuth-Forge#490
• Bismuth-Forge#480
• Bismuth-Forge#439

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

• AUR

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

OpenSUSE Tumbleweed

• KDE Extra Repository

Gentoo

• VipreML Overlay

From Source

• See Dev Docs

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.