LGUG2Z
d781028a2a
komorebi-for-kde/docs/ -> docs/linux/ komorebi-for-mac/docs/ -> docs/macos/ The Windows docs stay where they are (docs/). Renames only, so links and include paths that named the old directories are broken at this revision; they are fixed in the revision that fixes the paths of the whole layout move.
3.4 KiB
Resizing windows
komorebi resizes the focused window by moving the edges of its tile, and its neighbors give up
the room. A window can also be resized by dragging one of its edges. The size a tile has been
given is kept until the workspace is retiled with komorebic retile, so it lasts while windows
open and close around it.
An edge
komorebic resize-edge (or resize) moves one edge of the focused
window: left, right, up or down, and increase moves it outwards, decrease inwards.
komorebic resize-edge left increase
komorebic resize-edge right decrease
An edge with no tile on the other side of it, such as the left edge of the first window in the BSP layout, does not move. Neither does an edge the layout keeps where it is: the grid layout has no resizing at all, and in the columns layout a window can only be made wider or narrower.
An axis
komorebic resize-axis moves both edges of the focused window along an
axis: horizontal the left and the right edge, vertical the top and the bottom edge, and
horizontal-and-vertical all four.
komorebic resize-axis horizontal increase
How far
komorebic resize-delta sets how far a resize goes, in pixels: an
edge moves by half of it. The delta starts at 50, so an edge moves by 25 pixels.
komorebic resize-delta 100
A resize never makes a tile narrower or shorter than a tenth of the monitor's work area, unless the tile is smaller than that already: a resize that would is carried out as far as it can go.
By dragging an edge
Take hold of an edge or a corner of a tiled window with the pointer, drag it, and let go: the
edges of the window's tile move by as much as the pointer moved them, the neighbors give up or
take the room, and the window is put on its tile. The neighbors follow the edge while it is
dragged, and go back if it is dragged back to where it began, without the animation of
animation: the effect leaves a user's resize alone. A corner moves two edges. The rules
are those of resize-edge: an edge with no tile on the other side of it does not move, and the
window goes back to its tile; no tile is made smaller than a tenth of the work area, so a long
drag goes as far as it can. The window of a stack has the tile of the stack. A floating window and
the window of a monocle have no tile: they are left as the user made them. Resizing a tile by
dragging its edge says how a drag is measured.
Back to the layout
komorebic retile tiles every monitor again in its layout, without the
sizes the tiles were given. To tile again and keep them, send the RetileWithResizeDimensions
message, which has no subcommand of its own.
Saving and loading the sizes
The sizes the tiles of the focused workspace were given can be saved to a file and loaded back, on the same workspace or another one with as many windows:
komorebic save-resize ~/sizes.json
komorebic load-resize ~/sizes.json
komorebic quick-save-resize and
komorebic quick-load-resize do the same with one file the daemon
keeps in its temporary directory, komorebi.quicksave.json in $TMPDIR (or /tmp). A path
given to save-resize and load-resize can name environment variables, which komorebic
expands.