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
3.9 KiB
Markdown
84 lines
3.9 KiB
Markdown
# Padding and work area offsets
|
|
|
|
komorebi tiles the windows of a workspace in the work area of its monitor, which is the part of
|
|
the monitor that KWin reports free of Plasma's panels. Padding puts gaps around the tiles, and an
|
|
offset keeps a part of the work area free of tiles.
|
|
|
|
## Padding
|
|
|
|
A workspace has two paddings, in pixels:
|
|
|
|
- the **workspace padding**, between the edges of the work area and the tiles;
|
|
- the **container padding**, around each tile, so that two tiles side by side are twice that far
|
|
apart.
|
|
|
|
A workspace that has no padding of its own takes 5 pixels for each.
|
|
|
|
[`komorebic focused-workspace-padding`](../cli/focused-workspace-padding.md) and
|
|
[`komorebic focused-workspace-container-padding`](../cli/focused-workspace-container-padding.md)
|
|
set the paddings of the focused workspace, and
|
|
[`komorebic workspace-padding`](../cli/workspace-padding.md) and
|
|
[`komorebic container-padding`](../cli/container-padding.md) those of a workspace given by the
|
|
index of its monitor and its own, counted from 0.
|
|
|
|
[`komorebic named-workspace-padding`](../cli/named-workspace-padding.md) and
|
|
[`komorebic named-workspace-container-padding`](../cli/named-workspace-container-padding.md) find
|
|
the workspace by the [name](workspaces.md#names) it was given instead, on whichever monitor has
|
|
it. A name no workspace has changes nothing.
|
|
|
|
```sh
|
|
komorebic focused-workspace-padding 20
|
|
komorebic focused-workspace-container-padding 10
|
|
komorebic workspace-padding 0 1 0
|
|
komorebic container-padding 0 1 0
|
|
komorebic named-workspace-padding mail 0
|
|
komorebic named-workspace-container-padding mail 0
|
|
```
|
|
|
|
[`komorebic adjust-workspace-padding`](../cli/adjust-workspace-padding.md) and
|
|
[`komorebic adjust-container-padding`](../cli/adjust-container-padding.md) make a padding of the
|
|
focused workspace larger or smaller by a number of pixels. They change a padding the workspace
|
|
has of its own, set by one of the commands above: on a workspace that has none, the daemon logs
|
|
"there is no workspace padding" or "there is no container padding". A padding is not made
|
|
smaller than 0.
|
|
|
|
```sh
|
|
komorebic adjust-workspace-padding increase 5
|
|
komorebic adjust-container-padding decrease 5
|
|
```
|
|
|
|
## Work area offsets
|
|
|
|
An offset is four numbers. The first two move the top left corner of the work area right and
|
|
down; the last two make the work area narrower and shorter. So `0 40 0 40` keeps a strip of 40
|
|
pixels at the top free, `0 0 0 40` a strip at the bottom, and `40 0 40 0` a strip on the left.
|
|
|
|
[`komorebic global-work-area-offset`](../cli/global-work-area-offset.md) sets the offset of every
|
|
monitor, [`komorebic monitor-work-area-offset`](../cli/monitor-work-area-offset.md) the offset of
|
|
one monitor, which it takes instead of the global one, and
|
|
[`komorebic workspace-work-area-offset`](../cli/workspace-work-area-offset.md) the offset of one
|
|
workspace, which it takes instead of both. Each tiles every monitor again, as
|
|
[`komorebic retile`](../cli/retile.md) does.
|
|
|
|
```sh
|
|
komorebic global-work-area-offset 0 40 0 40
|
|
komorebic monitor-work-area-offset 1 0 0 0 40
|
|
komorebic workspace-work-area-offset 0 2 40 0 40 0
|
|
```
|
|
|
|
A monitor can also have a window-based offset, which applies on top of the other one while the
|
|
workspace in front has no more windows than the monitor's limit, 1 unless it is given another.
|
|
With a window-based offset, a window that is alone on a wide monitor does not have to take its
|
|
whole width. No command sets a monitor's window-based offset: it is part of the configuration of
|
|
a monitor.
|
|
[`komorebic toggle-window-based-work-area-offset`](../cli/toggle-window-based-work-area-offset.md)
|
|
turns it off for the focused workspace, and on again.
|
|
|
|
```sh
|
|
komorebic toggle-window-based-work-area-offset
|
|
```
|
|
|
|
The daemon's state has the offsets as `work_area_offset` (of the window manager, of each monitor
|
|
and of each workspace), and a monitor's window-based offset and limit as
|
|
`window_based_work_area_offset` and `window_based_work_area_offset_limit`.
|