mirror of
https://github.com/LGUG2Z/komorebi.git
synced 2026-11-14 21:04:04 +01:00
LGUG2Z
8467b03ac2
Workspace i is KWin's desktop i, and switching and moving by index came with the workspaces. What a user binds keys to besides is the rest of komorebi's workspace commands: going to the next or the previous workspace (or the next empty one), back to the last one, adding and closing workspaces, showing one index on every monitor, and setting the layout or the tiling of a workspace that need not be in front. They are made of the same two operations, showing a workspace and moving a container to one, so KWin keeps doing the showing and the hiding. A workspace gets a name, which focus-named-workspace, named-workspace-layout and named-workspace-tiling find it by on any monitor; focusing a named workspace focuses its monitor too, so focus_monitor comes with it. The name is komorebi's: naming a workspace does not rename KWin's desktop. The query focused-workspace-name answers with the name, or the index of a workspace that has none. The moves to a named workspace, and everything that addresses a monitor, are moves between monitors in the window manager and come with more than one monitor.
120 lines
5.4 KiB
Markdown
120 lines
5.4 KiB
Markdown
# Workspaces
|
|
|
|
Each monitor has workspaces, and shows one of them at a time. A workspace has its own windows
|
|
and its own layout. komorebi's workspaces are KWin's virtual desktops: workspace 0 is the first
|
|
desktop, workspace 1 the second, and so on, which is why the pager, the overview and KWin's
|
|
shortcuts show and switch them too.
|
|
|
|
komorebi turns on KWin's per-output virtual desktops when it starts, so that each monitor shows
|
|
a desktop of its own: switching the workspace of one monitor leaves the others as they are. It
|
|
puts the setting back as it was when it stops.
|
|
|
|
## Showing another workspace
|
|
|
|
[`komorebic focus-workspace`](../cli/focus-workspace.md) shows a workspace of the focused
|
|
monitor, by its number, counted from 0. KWin shows the windows of that workspace and hides the
|
|
others, and the window of that workspace that had the focus has it again.
|
|
|
|
```sh
|
|
komorebic focus-workspace 1
|
|
komorebic focus-workspace 0
|
|
```
|
|
|
|
A workspace that does not exist yet is created, with the ones before it, and KWin gets a
|
|
desktop for each, named "Workspace 2" and so on. A desktop that is there already keeps its
|
|
name. The desktops komorebi creates stay when it stops.
|
|
|
|
## Moving a window to another workspace
|
|
|
|
[`komorebic move-to-workspace`](../cli/move-to-workspace.md) takes the focused window to another
|
|
workspace, puts it after the windows there, and shows that workspace.
|
|
[`komorebic send-to-workspace`](../cli/send-to-workspace.md) does the same and stays on the
|
|
workspace in front, which is tiled again without the window.
|
|
|
|
```sh
|
|
komorebic move-to-workspace 1
|
|
komorebic send-to-workspace 2
|
|
```
|
|
|
|
## Going round the workspaces
|
|
|
|
[`komorebic cycle-workspace`](../cli/cycle-workspace.md) shows the next or the previous workspace
|
|
of the focused monitor, and wraps around at both ends;
|
|
[`komorebic cycle-empty-workspace`](../cli/cycle-empty-workspace.md) shows the next or the previous
|
|
one that has no window, if there is one.
|
|
[`komorebic cycle-move-to-workspace`](../cli/cycle-move-to-workspace.md) and
|
|
[`komorebic cycle-send-to-workspace`](../cli/cycle-send-to-workspace.md) take the focused window to
|
|
the next or the previous workspace, with and without showing it.
|
|
|
|
```sh
|
|
komorebic cycle-workspace next
|
|
komorebic cycle-empty-workspace previous
|
|
komorebic cycle-move-to-workspace next
|
|
```
|
|
|
|
## The last workspace
|
|
|
|
Each monitor remembers which workspace was in front before the one in front now.
|
|
[`komorebic focus-last-workspace`](../cli/focus-last-workspace.md) shows it again, so two in a row
|
|
go back and forth between the two.
|
|
[`komorebic move-to-last-workspace`](../cli/move-to-last-workspace.md) and
|
|
[`komorebic send-to-last-workspace`](../cli/send-to-last-workspace.md) take the focused window
|
|
there, with and without showing it.
|
|
|
|
## Names
|
|
|
|
[`komorebic workspace-name`](../cli/workspace-name.md) names a workspace, given by the index of its
|
|
monitor and its own index, and
|
|
[`komorebic ensure-named-workspaces`](../cli/ensure-named-workspaces.md) gives a monitor a workspace
|
|
for each name it is given, in order. The name is komorebi's, for the commands that find a
|
|
workspace by its name: KWin's desktop keeps the name it has.
|
|
[`komorebic focus-named-workspace`](../cli/focus-named-workspace.md) shows the workspace with that
|
|
name, on whichever monitor has it, and focuses that monitor. A name no workspace has changes
|
|
nothing. `komorebic query focused-workspace-name` prints the name of the workspace in front, or its
|
|
index when it has none.
|
|
|
|
```sh
|
|
komorebic ensure-named-workspaces 0 web code mail
|
|
komorebic focus-named-workspace mail
|
|
```
|
|
|
|
## Adding and removing workspaces
|
|
|
|
[`komorebic new-workspace`](../cli/new-workspace.md) adds a workspace after the last one of the
|
|
focused monitor and shows it, and [`komorebic ensure-workspaces`](../cli/ensure-workspaces.md)
|
|
gives a monitor at least as many workspaces as it is told.
|
|
[`komorebic close-workspace`](../cli/close-workspace.md) removes the workspace in front and shows
|
|
the one before it, when the workspace has no window and no name and is not the monitor's last.
|
|
|
|
[`komorebic focus-workspaces`](../cli/focus-workspaces.md) shows the workspace with the same index
|
|
on every monitor.
|
|
|
|
## The layout of another workspace
|
|
|
|
[`komorebic workspace-layout`](../cli/workspace-layout.md) and
|
|
[`komorebic workspace-tiling`](../cli/workspace-tiling.md) set the layout of a workspace, and turn
|
|
its tiling off or on, by the index of its monitor and its own index;
|
|
[`komorebic named-workspace-layout`](../cli/named-workspace-layout.md) and
|
|
[`komorebic named-workspace-tiling`](../cli/named-workspace-tiling.md) find it by its name. The
|
|
focused workspace is tiled again at once, and another workspace the next time it is tiled, when it
|
|
is shown at the latest.
|
|
|
|
```sh
|
|
komorebic workspace-layout 0 1 columns
|
|
komorebic named-workspace-tiling mail disable
|
|
```
|
|
|
|
## Switching with KWin
|
|
|
|
Anything that switches KWin's desktop switches komorebi's workspace: the pager, KWin's own
|
|
shortcuts, the overview, or an application that raises a window of another desktop (KWin then
|
|
shows that desktop and focuses the window). komorebi follows, tiles the workspace that came
|
|
into view, and asks KWin for nothing in reply. A window moved to another desktop with the
|
|
window menu's "Move to Desktop" moves to that workspace.
|
|
|
|
## The windows that were open before
|
|
|
|
When komorebi starts, each window that is open goes to the workspace whose desktop it is on,
|
|
and each monitor starts on the workspace KWin shows there. A window that is on every desktop
|
|
goes to the workspace in front.
|