Skip to content

Window Grab Modes

Leleat edited this page Mar 7, 2023 · 1 revision

Grabbing a window and moving it around will cause different tiling behaviors depending on the active window grab mode.

The default mode is Edge Tiling. Adaptive Tiling, Favorite Layout and Ignore Tiling Assistant can be activated by holding a modifier key during the window grab.

Additionally, if you hold Super, the grabbed window will tile over multiple tiles once the grab is released.

The default mode can be changed with Preferences > Default Window Movement Mode and the modifier keys to activate the other modes with Preferences > Other. Both are advanced settings.

Note that the default mode is activated when no modifier key is pressed. The only exception to that is Super. That means if you've set the window action key to Alt and use Alt to drag a window around, you need to release Alt for the default mode to activate.

Edge Tiling

This is the default window grab mode.

If you grab a window and drag it to the screen edges, a tile preview will open and show the area the window will tile to once the grab is released. By default, the tile size will either be a screen half or quarter depending on the position of your pointer. If there are tiled windows visible on the screen, the tile will adapt its size if it's possible. If a tiled window already occupies the desired tile, the grabbed window will use the default tile dimensions and create a new tile group. In case you want to add a window to an existing tile and tile group, use Adaptive Tiling.

The top screen edge is used for maximizing the window. Keeping the maximized preview open for a short time will switch to the top-half tile.

grab-mode-edge-tiling.mp4

Monitor Switch Grace Period

The monitor switch grace period isn't a dedicated grab mode. Instead it allows you to 'edge-tile' windows by 'throwing' them towards a monitor edge with your pointer, even if there is a different monitor beyond that edge. So you don't need to slowly inch towards a screen edge to tile a window.

This feature is implemented by having the tile preview stick to the old monitor for a very short time when a window leaves a monitor. It can be disabled with Preferences > General > Other > Monitor Switch Grace Period.

Required Extension Version

  • 23

Adaptive Tiling

By default, this grab mode is activated with Ctrl.

In this mode you split or replace tiles, if you hover over them. If you hover at the center of the tile, the full tile will be covered. If the covered tile contains a window, you will explicitly add the grabbed window to the existing tile group.

If you hover the sides, the grabbed window will only tile to one half of the full tile. If the hovered tile contains a window, the tiled window will make space for the grabbed window. If you hover at the very edges of a tile, multiple tiles will be affected by it.

grab-mode-adaptive-tiling.mp4

Required Extension Version

  • 32

Favorite Layout

By default, this grab mode is activated with Alt.

In this mode the tile for the grabbed window will not adapt its size to other tiles. Instead it will stick to your favorite layout. See Layouts for information on how to set one up and mark it as a favorite.

grab-mode-favorite-layout.mp4

Required Extension Version

  • 28

Ignore Tiling Assistant

By default, this grab mode has no modifier key assigned to it.

If this mode is used, the window grab will behave exactly like the Edge Tiling mode but it will neither spawn a Tiling Popup nor create a Tile Group.

Required Extension Version

  • 37