mirror of
https://github.com/LGUG2Z/komorebi.git
synced 2026-11-14 04:43:42 +01:00
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.
78 lines
3.4 KiB
Markdown
78 lines
3.4 KiB
Markdown
# 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`](../cli/resize-edge.md) (or `resize`) moves one edge of the focused
|
|
window: `left`, `right`, `up` or `down`, and `increase` moves it outwards, `decrease` inwards.
|
|
|
|
```sh
|
|
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`](../cli/resize-axis.md) 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.
|
|
|
|
```sh
|
|
komorebic resize-axis horizontal increase
|
|
```
|
|
|
|
## How far
|
|
|
|
[`komorebic resize-delta`](../cli/resize-delta.md) 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.
|
|
|
|
```sh
|
|
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`](animation.md): 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](../drag-resize.md) says how a drag is measured.
|
|
|
|
## Back to the layout
|
|
|
|
[`komorebic retile`](../cli/retile.md) 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:
|
|
|
|
```sh
|
|
komorebic save-resize ~/sizes.json
|
|
komorebic load-resize ~/sizes.json
|
|
```
|
|
|
|
[`komorebic quick-save-resize`](../cli/quick-save-resize.md) and
|
|
[`komorebic quick-load-resize`](../cli/quick-load-resize.md) 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.
|