Skip to content

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

License

Notifications You must be signed in to change notification settings

JCapucho/bismuth

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌈 Bismuth

Conventional Commits code style: prettier wayland: supported AUR version

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! 🦾

script demo

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.

Bismuth Configuration Module

⌨️ 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

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 80.7%
  • QML 10.7%
  • Shell 4.1%
  • CMake 3.3%
  • C 1.2%