KDE Plasma add-on, that tiles your windows automatically and lets you manage them via keyboard, similarly to i3, Sway or dwm.
Go to file
2021-10-15 00:47:32 +03:00
.github ci: 👷 publish artifacts on release 2021-10-03 17:09:56 +03:00
.husky fix: 🐛 Monocle Layout "minimize unfocused windows" fixes and improvements 2021-09-30 14:47:14 +03:00
.reuse build: 📝 use SPDX statements for licencing 2021-09-04 18:22:29 +03:00
.vscode chore: 🔧 add vscode workspace config with wayland CC scope 2021-09-23 13:50:04 +03:00
bin build: improve tsc recompilation times 2021-10-08 23:48:19 +03:00
contrib fix: 🐛 correctly import Tile Layout Krohnkite shortcut 2021-10-03 19:29:20 +03:00
img docs: 📝 add video demonstration 2021-09-17 21:24:27 +03:00
LICENSES build: 📝 use SPDX statements for licencing 2021-09-04 18:22:29 +03:00
res refactor: ♻️ improve logging 2021-10-12 14:02:49 +03:00
src fix: 🐛 put shaded windows to float state to avoid layout breakage 2021-10-15 00:47:32 +03:00
test test: add a few basic tests with mocks 2021-09-16 18:25:18 +03:00
.eslintrc.json ci: 👷 add prettier eslint plugin 2021-09-30 19:21:10 +03:00
.eslintrc.json.license build: mode eslint to a separate file 2021-09-09 00:16:48 +03:00
.git-blame-ignore-revs build: 📝 use SPDX statements for licencing 2021-09-04 18:22:29 +03:00
.gitignore build: improve tsc recompilation times 2021-10-08 23:48:19 +03:00
.prettierignore build: 📝 use SPDX statements for licencing 2021-09-04 18:22:29 +03:00
CHANGELOG.md chore: release 1.0.1 2021-10-03 02:26:59 +03:00
config.ts test: add a few basic tests with mocks 2021-09-16 18:25:18 +03:00
CONTRIBUTING.md build: 📦 package as an archive with install script 2021-10-02 22:58:11 +03:00
LICENSE chore: 📝 add license symlink for GitHub recognition 2021-09-23 23:00:15 +03:00
package.json chore: release 1.0.1 2021-10-03 02:26:59 +03:00
package.json.license build: 📝 use SPDX statements for licencing 2021-09-04 18:22:29 +03:00
README.md docs: 📝 provide quick installation instructions 2021-10-03 01:38:21 +03:00
tsconfig.json test: add a few basic tests with mocks 2021-09-16 18:25:18 +03:00
tsconfig.json.license build: 📝 use SPDX statements for licencing 2021-09-04 18:22:29 +03:00
TWEAKS.md chore: 🐛 add config tweak to install script and update docs 2021-09-23 20:39:31 +03:00

🌈 Bismuth

Conventional Commits code style: prettier wayland: supported

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 the script on any KDE Plasma powered Linux distribution and enjoy your computing! 🦾

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.

🗺️ Goals

Project goals are the following:

  1. Provide full-fledged tiling window manager experience in KDE Plasma with minimal effort on user side
  2. Wayland support

🌟 Features

  • Automatic window tiling
    • Dynamically tile windows, rather than manually placing each.
    • Floating windows
  • Fully integrates into KWin features, including:
    • Multi-screen
    • Activities & Virtual desktop
    • Basic window management (minimize, fullscreen, switching, etc)
  • Multiple Layout Support
    • Tiling layout
    • Monocle layout
    • Desktop-friendly layouts (Spread, Stair)

🔧 Installation

Simple and Quick

Paste the following script in the command line:

wget -q -O - https://git.io/J2gLk | sh

This will download the latest release and execute the installation script.

Manual

Alternatively, go to releases, download the latest bismuth.tar.gz archive, unzip it and execute the installation script, that is inside.

From Source

Install script from source:

npm install # Installs dependencies for building
npm run script-install

To uninstall:

npm run script-uninstall

Tweaks

Note, that if you've installed the script from the KWin scripts installation dialog, you need to make a couple of manual fixes and tweaks. See Tweaks section.

⌨️ 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 Part Meta + Shift + R