Mouse poller does not work on Wayland anyway. It uses xdottool, which does not work on Wayland. This will break the setup of the users, who used the config setting to use xdotool |
||
---|---|---|
.github | ||
.husky | ||
.reuse | ||
.vscode | ||
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 |