I honestly do not understand why is this needed, but it prevents running script on Wayland session entierly. In the docs this parameter is marked as unreliable anyway and we do not want to support non-crossplatform features. This will surely break something. I do not know what and when. |
||
---|---|---|
.github | ||
.husky | ||
.reuse | ||
bin | ||
img | ||
LICENSES | ||
res | ||
src | ||
test | ||
.eslintrc.json | ||
.eslintrc.json.license | ||
.git-blame-ignore-revs | ||
.gitignore | ||
.prettierignore | ||
config.ts | ||
CONTRIBUTING.md | ||
package.json | ||
package.json.license | ||
README.md | ||
tsconfig.json | ||
tsconfig.json.license | ||
TWEAKS.md |
🌈 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 the script on any KDE Plasma powered Linux distribution and enjoy your computing! 🦾
This is a fork of Krohnkite. The fork was made, because the old project seems to be unmaintained.
🗺️ Goals
Project goals are the following:
- Provide full-fledged tiling window manager experience in KDE Plasma with minimal effort on user side
- 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
Install script via script:
npm install # Installs dependencies for building
npm run script-install
To uninstall:
npm run script-uninstall
Enabling User-Configuration
It is reported that a manual step is required to enable user configuration of KWin scripts. This is a limitation of KWin scripting.
To enable configuration, you must perform the following in command-line:
mkdir -p ~/.local/share/kservices5/
ln -s ~/.local/share/kwin/scripts/bismuth/metadata.desktop ~/.local/share/kservices5/bismuth.desktop
A configuration button will appear in KWin Scripts
in System Settings
.
To make changes effective, the script must be reactivated:
- On
KWin Scripts
dialog, untick Bismuth Apply
- tick Bismuth
Apply
Tweaks
Proceed to the TWEAKS section.
⌨️ Default Key Bindings
Key | Action |
---|---|
Meta + J | Focus Down/Next |
Meta + K | Focus Up/Previous |
Meta + H | Left |
Meta + L | Right |
Meta + Shift + J | Move Down/Next |
Meta + Shift + K | Move Up/Previous |
Meta + Shift + H | Move Left |
Meta + Shift + L | Move Right |
Meta + I | Increase |
Meta + D | Decrease |
Meta + F | Toggle Floating |
Meta + \ | Cycle Layout |
Meta + Return | Set as Master |
Meta + T | Use Tile Layout |
Meta + M | Use Monocle Layout |
unbound | Use Spread Layout |
unbound | Use Stair Layout |