/bismuth

KDE Plasma add-on, that tiles your windows automatically and lets you manage them via keyboard, similarly to i3, Sway or dwm.

Primary LanguageTypeScriptOtherNOASSERTION

🌈 Bismuth 🌈

Making tiling window management easy. On KDE Plasma.

wayland: supported GitHub release (latest SemVer) Matrix Open Collective backers and sponsors

demo

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

Ubuntu

Fedora

Solus

OpenSUSE Tumbleweed

Gentoo

From Source

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.

Bismuth Configuration Module

🤝 Acknowledgments

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