volitank / bismuth

KDE Plasma extension, that lets you tile your windows automatically and manage them via keyboard, just like in classical tiling window managers (i3, dwm or XMonad).

🌈 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

Project vision and road map can be found here.

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

Fedora

Bismuth is available on the Copr

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

☝️ Don't forget to enable window tiling in the new settings module: System Settings > Window Management > Window Tiling.

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