mirror of
https://github.com/LGUG2Z/komorebi.git
synced 2026-11-14 12:53:43 +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.
84 lines
4.3 KiB
Markdown
84 lines
4.3 KiB
Markdown
# Floating windows
|
|
|
|
A floating window is one of a workspace's windows that is not in its layout: komorebi gives it no
|
|
tile and does not move it, and it stays where it is put by hand.
|
|
|
|
[`komorebic toggle-float`](../cli/toggle-float.md) takes the window that has the focus out of the
|
|
layout, and the other windows of the workspace share the work area. The same command on a
|
|
floating window puts it back in the layout, at the place of the focused window.
|
|
|
|
```sh
|
|
komorebic toggle-float
|
|
```
|
|
|
|
A floated window keeps its size and position by default. The floating windows of a workspace are
|
|
in the daemon's state as `floating_windows`, next to its containers.
|
|
|
|
## Windows that open floating
|
|
|
|
With the float override on, every window that opens floats instead of getting a tile.
|
|
[`komorebic toggle-float-override`](../cli/toggle-float-override.md) turns it on and off for every
|
|
workspace, and
|
|
[`komorebic toggle-workspace-float-override`](../cli/toggle-workspace-float-override.md) for the
|
|
focused workspace only: the first time it takes the opposite of what every workspace has, and from
|
|
then on it follows its own setting.
|
|
|
|
```sh
|
|
komorebic toggle-float-override
|
|
komorebic toggle-workspace-float-override
|
|
```
|
|
|
|
The override is in the daemon's state, as `float_override` for every workspace and in each
|
|
workspace that has one of its own.
|
|
|
|
In `komorebi.json` it is `float_override`, for every workspace and in the entry of a workspace.
|
|
`float_override_placement` says what is done to the window the override floats: `None` leaves it
|
|
where KWin put it, `Center` centers it in the work area and `CenterAndResize` also makes it half
|
|
as tall as the work area, with the aspect ratio `floating_window_aspect_ratio` names. A window is
|
|
centered only on a workspace that tiles.
|
|
|
|
## The two layers
|
|
|
|
A workspace is on one of two layers: its tiles, or its floating windows. Which one decides what
|
|
[`komorebic focus`](../cli/focus.md), [`cycle-focus`](../cli/cycle-focus.md),
|
|
[`move`](../cli/move.md) and [`resize-edge`](../cli/resize-edge.md) act on. Floating a window puts
|
|
the workspace on its floating layer, and giving the focus to a tiled window, with the pointer or a
|
|
command, puts it back on its tiling layer. A window that opens and is tiled does the same, and so
|
|
does putting a floating window back in the layout.
|
|
|
|
[`komorebic toggle-workspace-layer`](../cli/toggle-workspace-layer.md) switches the layer by hand.
|
|
The windows of the layer it goes to are raised in front of the others, and one of them is given the
|
|
focus: the focused floating window, or the focused container's window. Going to the tiles hides the
|
|
floating windows, and going back to the floating layer shows them.
|
|
|
|
```sh
|
|
komorebic toggle-workspace-layer
|
|
```
|
|
|
|
On the floating layer:
|
|
|
|
- `focus left`, `right`, `up` and `down` give the focus to the nearest floating window on that
|
|
side, by where KWin has them. When no floating window is on that side the focus goes to the
|
|
monitor on that side, as it does for tiles, and the command fails where there is none: the
|
|
daemon logs "there is no container or monitor in this direction".
|
|
- `cycle-focus next` and `previous` go round the floating windows in the order they were floated,
|
|
and wrap around.
|
|
- `move` moves the focused floating window by the [resize delta](resizing-windows.md), 50 pixels
|
|
unless it was set, and not out of the work area.
|
|
- `resize-edge` and `resize-axis` change the frame of the focused floating window: `increase` on
|
|
the left or the upper side moves it that way, and on the right or the lower side makes it wider
|
|
or taller by twice the delta; `decrease` does the opposite.
|
|
- `preselect-direction` does nothing.
|
|
|
|
[`komorebic toggle-maximize`](../cli/toggle-maximize.md) maximizes the focused floating window
|
|
there, and when it is restored it is a tile, not a floating window.
|
|
|
|
The layer is `layer` in the state of each workspace, `Tiling` or `Floating`.
|
|
|
|
What a window that opens while a workspace is on its floating layer gets is
|
|
`floating_layer_behaviour` in `komorebi.json`: `Tile`, the default, gives it a tile, and `Float`
|
|
floats it, centered in the work area as `floating_layer_placement` says (`Center` by default; the
|
|
values are those of `float_override_placement`). The entry of a monitor and the entry of a
|
|
workspace can have a `floating_layer_behaviour` of their own: the workspace's comes before the
|
|
monitor's, which comes before the one for every monitor.
|