Files
komorebi/docs/usage/focusing-windows.md
T
LGUG2Z 554d77aed9 feat(wm): promote
The first tile of a layout is its largest, and the place for the window being
worked on. `komorebic promote` moves the focused window there, with the windows
that were before it each moving one tile on; `promote-swap` swaps it with the
window that has the first tile, and from the first tile swaps it back with the
window it was last swapped with; `promote-window left|right|up|down` promotes
the window on that side of the focused one; and `promote-focus` gives the focus
to the first tile and moves nothing.

The grid layout has no largest tile, so the four do nothing there.

The vm-commands sweep gains the four.
2026-10-28 07:20:37 -07:00

2.2 KiB

Focusing windows

komorebi gives the focus to another window of the focused workspace when it is told to. It moves no window to do it: the windows stay on their tiles, and KWin makes the chosen one the active window.

In a direction

komorebic focus focuses the window whose tile is on one side of the focused one: left, right, up or down. Which tile is on which side is the layout's business. In the BSP layout with three windows, for example, the first window has the left half, and focus right from it goes to the window at the top right.

komorebic focus left
komorebic focus down
komorebic focus up
komorebic focus right

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

In order

komorebic cycle-focus focuses the next or the previous window in the order of the workspace, which is the order in which the windows were opened, each new one after the window that had the focus. It wraps around: next from the last window is the first.

komorebic cycle-focus next
komorebic cycle-focus previous

The largest tile

komorebic promote-focus focuses the window on the first tile of the layout, which is its largest (Moving windows).

The pointer

By default the pointer moves to the middle of the window that is given the focus. komorebi asks KWin to do it with its "Move Mouse to Focus" shortcut, so the pointer follows only in a session that has KWin's global shortcuts (a headless KWin has none). komorebic mouse-follows-focus turns this on or off, and komorebic toggle-mouse-follows-focus switches between the two:

komorebic mouse-follows-focus disable
komorebic toggle-mouse-follows-focus

The setting is in the daemon's state as mouse_follows_focus, and it lasts until the daemon stops.

Binding them to keys

komorebi reads no keys. Bind the commands to keys in Plasma's System Settings, under Keyboard, Shortcuts, as custom shortcuts that run a command: for example Meta+H for komorebic focus left and Meta+L for komorebic focus right.