Awesome Open Source
Awesome Open Source

Quarter Tiling Script for KWin


Easy tiling script for KWin. Thanks to the simple tiling layouts and mouse-driven controls, the script should feel familiar to users with no prior experience with tiling window managers.

The script is not supposed to be a replacement for a tiling window manager, but a simple tool to easily combine the strengths of tiling and floating window managers.






Arch Linux: AUR

Other: KDE Store


git clone
plasmapkg2 --type kwinscript -i kwin-quarter-tiling
mkdir -p ~/.local/share/kservices5
ln -sf ~/.local/share/kwin/scripts/quarter-tiling/metadata.desktop ~/.local/share/kservices5/kwin-script-quarter-tiling.desktop


The script is configured through the configuration interface under "Kwin Scripts". If you encounter programs that do not work with tiling, you can ignore them via the configuration interface.

NOTE: If the configuration interface is not visible, the metadata.desktop file of the script needs to be added to ~/.local/share/kservices5 folder as kwin-script-quarter-tiling.desktop. This is something KWin does not do automatically when installing the script, so you might need to do it manually:

mkdir -p ~/.local/share/kservices5
ln -sf ~/.local/share/kwin/scripts/quarter-tiling/metadata.desktop ~/.local/share/kservices5/kwin-script-quarter-tiling.desktop


Go to System Settings » Shortcuts » Global Shortcuts » KWin and search for "Quarter" to find all the script specific shortcuts. Bind the ones you wish to use. "Float On/Off" is recommended for an easy way to tile and untile the active window.



git clone && plasmapkg2 --type kwinscript -u kwin-quarter-tiling

Alternatively, set this repository as the git origin of ~/.local/share/kwin/scripts/quarter-tiling. If you don't know how to do this, move the hidden .git folder inside the cloned folder to the location above. After this, the script can be updated by using git fetch origin && git pull.


Arch users can keep the script updated through AUR.


plasmapkg2 --type kwinscript -r .local/share/kwin/scripts/quarter-tiling

Contributions and adjustments

The script is written in TypeScript and transpiled to JavaScript. If you modify the .ts files, you have to run npm install && npm run transpile to apply the changes you've made.

New tiling layouts can be created without touching the existing code. New layouts should be placed under src/layouts. New layouts will work as long as the layouts implement the interface described in src/layout.ts. If you create a new layout, feel free to open a pull request and it'll be added to master.

Suggestions, pull requests and bug reports are welcome!

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
javascript (68,711
typescript (10,876
kde (35
tiling (18

Find Open Source By Browsing 7,000 Topics Across 59 Categories