51n7/ktile

kTile

This is a Kwin script that allows you to create a desktop regions by grid selection, then lets you quickly snap the window to that position.

Installation

Option 1:

• Copy package folder to the following directory and rename to ktile:

~/.local/share/kwin/scripts/

• Log out and back in

Option 2:

• Go to System Settings -> Window Management -> KWin Scripts
• Click "Install from File..."
• Select kTile.kwinscript from this repo

Enable Script:

• Go to System Settings -> Window Management -> KWin Scripts
• Select the kTile script and hit Apply:

Usage

By default the script uses Ctrl + . to bring up the main window, to change this see the configuration section below. In the main window you can click the ➕ button in the top right to add a new region then hover over the new region to see the edit and delete options. In edit mode you can then drag select to draw the size/position you want and also set the grid and gap you need. Once you're done hit the ✔️ button to save.

Configuration

Most of the configuration is done through the graphical interface however due to Kwin limitations shortcuts have to be predefined but can be updated in System Settings -> Shortcuts -> KWin.

Note that I've added a visibility button (main window top right) to toggle numbers on each region block to easily connect it with the Kwin shortcuts.

Known Issues

If you're using this script on KDE Neon or Kubuntu you will need to install the following package:

KDE Neon

sudo pkcon install qml-module-qtquick-localstorage

Kubuntu

sudo apt-get install qml-module-qtquick-localstorage

Technical Notes

• This application is written 100% in QML.
• A core part of this script relies on QML Local Storage to allow using custom UI to save settings. I would love to have the settings interated into KDE's configuration window but currently that doesnt seem possible as it only accpets basic form controls through XML.

As this is my first time writing a Kwin script and using QML I realize there is a lot for me to refactor here. Any feedback would be much appreciated by creating a new issue.

TODO:

• save custom grid size
• bug with sqlite not reindexing table
• allow gap resize
• close with escape
• close by clicking outside window
• quick full screen drag selection

Special Thanks

This would not be possible with out inspiration from Moom and Exquisite, so many many thanks to both of these great apps.

ktile's Issues

Is this compatible with 22.04 ?

Hello, I have activated the script, but I can't open the GUI (CTRL + .) and the shortcuts aren't available in the shortcut tab .
Maybe because of my kubuntu version ?

small bug: kTile window does not size for 3 rows of tiles

If you have more than 8 layouts, it does not become taller to show the other rows.

small bug: does not always remember/respect border/padding values

I have created a tile with 0 padding.

Sometimes when I use kTile to move/resize a window, it still adds some padding.

small bug: does not auto close when using keyboard shortcut to select layout

If you click on a layout, it'll move/resize the window and then hide the kTile window.

If you use a keyboard shortcut to select a layout, it'll move/resize the window, but it does not hide the kTile window.

Feature Request: Multi-Monitor Support

As the title says, it would be nice to have multiple monitor support. In my case I have two monitors that are different (one vertical). Setting up tiles for this case doesn't seem to be viable using kTile at the moment.

does not install on KDE 6

I am getting this error:

Installation of /tmp/cNSjdv-kTile.kwinscript failed: Package is not considered valid