🌈 Bismuth

Arrange your windows automatically and switch between them using keyboard shortcuts. All of that with different layouts and without a complicated setup of classic tiling window managers (i3, dwm or XMonad). Just install Bismuth on any KDE Plasma powered Linux distribution and you are ready to go! 🦾

This is a fork of Krohnkite. The fork was made, because the old project seems to be unmaintained. If you want to import your old shortcuts from it, use the contrib/import_krohnkite.sh script.

🌟 Features

Full KDE Plasma integration
- Multiple Screens, Activities and Virtual desktops
- Built-in KWin features (minimize, full-screen and rules)
- Floating Dialog windows
Multiple Layouts
- Classic Tiling layout
- Monocle layout for focusing on one application
- Three-Column for wide monitors
- Floating layout for traditional experience
Works on Wayland Plasma session

🔧 Installation

From Source

Install script from source:

npm install # Installs dependencies for building
npm run sysdep-install # Install system dependencies for building
npm run bi-install # Installs all Bismuth components

To uninstall:

npm run bi-uninstall

From distribution packages

⚠️ These packages are not affiliated with plugin developers. If you encounter any issues, you should contact the package maintainer first.

Arch-based distros

Bismuth is available on AUR. Install the kwin-bismuth package with your favorite AUR helper.

Gentoo

Updated ebuilds provided in viperML-overlay.

Other distributions

If you are know a packaging solution for a distibution, that is not in this list, please provide a link to it via pull request.

Tweaks

You may want to make a couple of manual fixes and tweaks, to improve your experience. See Tweaks section.

⚙️ Configuration

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

⌨️ Actions and Default Keyboard Shortcuts

Action	Key
Focus Next Window	None
Focus Previous Window	None
Focus Upper Window	Meta + J
Focus Bottom Window	Meta + K
Focus Left Window	Meta + H
Focus Right Window	Meta + L

Move Window To Next Position	None
Move Window To Previous Position	None
Move Window Up	Meta + Shift + J
Move Window Down	Meta + Shift + K
Move Window Left	Meta + Shift + H
Move Window Right	Meta + Shift + L

Increase Window Width	Meta + Ctrl + L
Increase Window Height	Meta + Ctrl + J
Decrease Window Width	Meta + Ctrl + H
Decrease Window Height	Meta + Ctrl + K

Increase Master Area Window Count	Meta + ]
Decrease Master Area Window Count	Meta + [
Increase Master Area Size	None
Decrease Master Area Size	None
Push Window Into Master Area	Meta + Return

Toggle Active Window Floating	Meta + F

Switch To Next Layout	Meta + \
Switch To Previous Layout	Meta + \|

Set Tile Layout	Meta + T
Set Monocle Layout	Meta + M
Set Three Column Layout	None
Set Spread Layout	None
Set Stair Layout	None
Set Floating Layout	Meta + Shift + F
Set Quarter Layout	None

Rotate	Meta + R
Rotate (Reverse)	None
Rotate Part	Meta + Shift + R

pasqui23/bismuth