kwin-clicktile

Mouse-driven grid tiling for KWin on Wayland.

kwin-clicktile is a C++ KWin effect. While you are dragging a window by its titlebar, right-click starts a tile selection overlay. Move across the monitor grid, then release left click or right-click again to place the window into the selected tile range.

Takes inspiration from the Windows program WindowGrid.

Build And Toggle

You will need the following packages to run the build process on install. Use google to translate to your package manager of choice.

# Arch Linux
sudo pacman -S cmake extra-cmake-modules vulkan-headers vulkan-icd-loader

Use the root script for both install and uninstall:

./install_uninstall.sh

Configure

Open:

System Settings
Window Management
Desktop Effects
kwin-clicktile
enable it and apply

Settings:

• columns and rows for each monitor
• coloring of overlay grid, selection fill, and selection border

Emergency unload:

qdbus6 org.kde.KWin /Effects org.kde.kwin.Effects.unloadEffect kwin_clicktile

Source Layout

• src/effect.*: effect lifecycle and KWin integration
• src/input*: hooks into the mouse input and tracks the state
• src/tiles.cpp: tile selection, output geometry, and final placement
• src/overlay.cpp: painting of screen grid overlay
• src/settings.*: KWin config keys, defaults, and monitor settings
• kcm/: System Settings