Bismuth-Forge/bismuth

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

TypeScript

2,418

590 commits

updated May 23, 2024

See the code

README

🌈 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.

https://user-images.githubusercontent.com/14205339/148453685-f1bcfa46-4952-4b9d-a6f1-d2d75a0b4992.mp4


Plasma integration

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

https://user-images.githubusercontent.com/14205339/148562411-c9cca82a-c694-4794-b5e4-8fe716ec3d98.mp4


Multiple Layouts

Use different layouts in different contexts.

https://user-images.githubusercontent.com/14205339/148564378-1def9350-a871-4f75-ba66-7a59ea1d4680.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.

desktop
kcm
kde
kde-plasma
kwin
kwin-script
linux
plasma
tiling
tiling-window-manager
wayland
window
window-manager

Bismuth-Forge/bismuth

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

TypeScript

2,418

590 commits

updated May 23, 2024

See the code

README

🌈 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.

https://user-images.githubusercontent.com/14205339/148453685-f1bcfa46-4952-4b9d-a6f1-d2d75a0b4992.mp4


Plasma integration

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

https://user-images.githubusercontent.com/14205339/148562411-c9cca82a-c694-4794-b5e4-8fe716ec3d98.mp4


Multiple Layouts

Use different layouts in different contexts.

https://user-images.githubusercontent.com/14205339/148564378-1def9350-a871-4f75-ba66-7a59ea1d4680.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.

desktop
kcm
kde
kde-plasma
kwin
kwin-script
linux
plasma
tiling
tiling-window-manager
wayland
window
window-manager

Significant stargazers

(top 24 of 45)

Ollie Charles

782 followers Β· starred Jan 2023

Edwin Kofler

376 followers Β· starred Aug 2026

Michal Rostecki

298 followers Β· starred Dec 2023

Fabrizio Ferrai

225 followers Β· starred Feb 2022