Files
komorebi/docs/usage/moving-windows.md
T
LGUG2Z 3cc5dceb7d feat(wm): lock
Containers can be locked since the model came in, and a locked container keeps
its index while others are inserted, removed or swapped around it; nothing could
lock one. `komorebic toggle-lock` locks the focused container, or unlocks it,
and the `LockMonitorWorkspaceContainer` and `UnlockMonitorWorkspaceContainer`
messages lock and unlock a container by the index of its monitor, its workspace
and itself, for a program such as a status bar.

The vm-commands sweep locks and unlocks a container.
2026-10-28 07:20:37 -07:00

2.8 KiB

Moving windows

komorebi moves the focused window to another tile of its workspace when it is told to. The window swaps places with the window on that tile, the workspace is tiled again, and the window that moved keeps the focus.

In a direction

komorebic move swaps the focused window with the window whose tile is on one side of it: left, right, up or down. As with komorebic focus, the layout decides which tile is on which side.

komorebic move left
komorebic move down
komorebic move up
komorebic move right

When there is no tile on that side, nothing moves, and the daemon logs "there is no container in this direction".

In order

komorebic cycle-move swaps the focused window with the next or the previous window in the order of the workspace, and wraps around: next from the last window swaps it with the first.

komorebic cycle-move next
komorebic cycle-move previous

To the largest tile

The first tile of a layout is the largest one: the left half in BSP and the vertical stack, the top half in the horizontal stack, the middle of the ultrawide vertical stack and the right half in the right main vertical stack. In the columns, rows and scrolling layouts it is the first column or row. The grid layout is left alone: these commands do nothing there.

komorebic promote moves the focused window to the first tile, and the windows that were before it each move one tile on. komorebic promote-swap swaps the focused window with the window on the first tile instead, and from the first tile swaps it back with the window it was last swapped with. komorebic promote-window promotes the window on one side of the focused one.

komorebic promote
komorebic promote-swap
komorebic promote-window left

komorebic promote-focus gives the focus to the window on the first tile and moves nothing.

Locking a window in its place

komorebic toggle-lock locks the focused window's container at its place in the order of the workspace, and unlocks it again. Windows that open, close or move around a locked container leave it where it is: a new window that would go in its place goes after it. A window moved onto the place of a locked one with move, cycle-move or promote-swap is locked there instead, since the lock belongs to the place.

komorebic toggle-lock

The LockMonitorWorkspaceContainer and UnlockMonitorWorkspaceContainer messages lock and unlock a container by the index of its monitor, its workspace and itself, for a program such as a status bar. They have no subcommand.

The pointer

The pointer follows the window that moved, unless mouse follows focus is off.