Configuration

Configuration is accessed through the KWin Scripts settings menu.

General

• Rebuild Delay - How long no events must occur before event processing happens. Keep this low for responsiveness.
• Tile Resize Amount - How much to resize tiles by when using the resizing shortcuts.
• Use DBus Saver - Turn on to enable DBus interaction with polonium-saver.

Debug

• Log Level - The verbosity of the logging system. Set to at least “Log” for log reports.

Engine

• Default Engine - The default tiling engine to use.
  • BTree - Binary tree engine
  • Half - Master-stack split engine
  • ThreeColumn - Centered master-stack with two stacks
  • Pillars - Several stacks of windows
  • Pager - Focused layout with active window as dominant
  • KWin - Untiled layout with KWin vanilla tile support

Binary Tree

• Swap Insert Side - Swaps which side new windows are inserted into.
• Rotate Layout - Rotates the layout to be vertical.
• Insertion Style - Sets how new windows should be inserted.
  • Shallow - Insert breadth-first, causes windows to be evenly sized.
  • Dwindle - Insert depth-first, newer windows get progressively smaller.
  • Spiral - Insert depth-first, golden ratio spiral inwards.
• Insert New Windows in Active Tile - Adds new windows into the currently focused tile.

Half

• Swap Insert Side - Swaps which side new windows are inserted into.
• Middle Split - Percentage of layout to be given to the left side.
• Rotate Layout - Rotates the layout to be vertical.
• Keep Master - Maintains one window in the dominant side of the stack.
• Insert New Windows in Active Tile - Adds new windows into the currently focused tile.

Three Column

• Swap Insert Side - Swaps which side new windows are inserted into.
• Side 1 Size - Percentage of layout to be given to the left side.
• Side 2 Size - Percentage of layout to be given to the right side.
• Rotate Layout - Rotates the layout to be vertical.

Pillars

• Pillar Count - How many pillars there should be.
• Swap Insert Side - Swaps which side new windows are inserted into.
• Rotate Layout - Rotates the layout to be vertical.
• Insertion Style - Sets how new windows should be inserted.
  • Rows - Insert left-to-right, going down after a row is full.
  • Snake - Insert first left-to-right then the other way, going down after a row is full.
  • Rows Up - Insert left-to-right, going up after a row is full.
  • Snake Up - Insert first left-to-right then the other way, going up after a row is full.
• Insert New Windows in Active Tile - Adds new windows into the currently focused tile.

Pager

• Page Width - The relative width of minimized pages. As of right now, cannot be below 0.15.
• Swap Insert Side - Swaps which side new windows are inserted into.
• Rotate Layout - Rotates the layout to be vertical.

KWin

No settings are available for this layout. Configuration is done via the KWin tile editor.

Windows

• Borders - How window borders should be distributed.
• Place Tiled Windows Below - Whether tiled windows should be forced below floating/fullscreen ones.
• Window Dragging Policy - How dragged windows should be treated.
• Drag Retile Point - The reference point to use when retiling a dragged window.

Filters

Note that all text fields accept regex. Commas are replaced with regex OR statements (|) for backwards compatibility and readability. Additionally, the regex is wrapped with ^ and $ to prevent empty matching.

• Use Raw Regex - If true, then commas will not be converted into regex ORs and the regex will not be wrapped.
  • Use with caution as empty strings will match everything!
• Ignore Window Classes - If a window class matches this regex, it will be completely ignored by the engine.
• Ignore Window Captions - If a window caption (title) matches this regex, it will be completely ignored by the engine.
• Untile Window Classes - If a window class matches this regex, it will not be automatically tiled.
• Untile Window Captions - If a window caption (title) matches this regex, it will not be automatically tiled.
• Tile Popup Windows - Whether to tile popup windows.