Quick shortcuts for arranging windows in a specified grid with optional gaps

This project is based on kwin-typescript-template

Download the latest release from the releases page or with:

wget https://github.com/RubixDev/kwin-window-grid/releases/latest/download/window-grid.kwinscript

To install the file:

kpackagetool5 --type=KWin/Script -i window-grid.kwinscript

Note: Use -u instead of -i when updating

To get the config menu also run these two commands:

mkdir -p ~/.local/share/kservices5
ln -s ~/.local/share/kwin/scripts/window-grid/metadata.desktop ~/.local/share/kservices5/window-grid.desktop

First make sure you have NodeJS and NPM installed. Then follow these steps:

Clone this repo:

git clone https://github.com/RubixDev/kwin-window-grid

Install dependencies:

npm i

Build and install script:

npm start

The gap and grid size can be configured in System Settings -> Window Management -> KWin Scripts with the gear icon next to the script.

Note: After changing the settings you must reload the script. (Uncheck, Apply, Check, Apply)

The script registers a bunch of new shortcuts, all prefixed with 'Window Grid: '

Note: Some of the default keybindings may not be set when other shortcuts already use them. You can set them manually in System Settings -> Shortcuts -> KWin