Workspaces
Mosaico supports up to 8 independent workspaces per monitor. Each workspace maintains its own set of tiled windows.
Switching Workspaces
| Shortcut | Action |
|---|---|
Alt + 1 – Alt + 8 | Switch to workspace 1-8 |
Alt + Shift + 1 – Alt + Shift + 8 | Send focused window to workspace 1-8 |
Or via the CLI:
mosaico action goto-workspace 3
mosaico action send-to-workspace 5
Behavior
Switching (goto-workspace)
When you switch to a different workspace:
- All windows on the current workspace are hidden using the configured hiding strategy
- All windows on the target workspace are shown
- The layout is reapplied
- Focus is set to the first window
If you are already on the target workspace, nothing happens.
Sending (send-to-workspace)
When you send a window to another workspace:
- The focused window is removed from the current workspace
- It is added to the target workspace
- The window is hidden (it is now on a non-active workspace)
- The current workspace is retiled
- Focus moves to the next window
Hiding Behaviour
The hiding setting in [layout] controls how windows are hidden during
workspace switches:
| Strategy | Taskbar Icon | Notes |
|---|---|---|
"cloak" (default) | Kept | Invisible via DWM. Same mechanism as Windows virtual desktops. |
"hide" | Removed | Legacy SW_HIDE. Simple but loses taskbar icons. |
"minimize" | Kept (minimized) | Some apps react to minimize (e.g. pause media). |
[layout]
hiding = "cloak" # "cloak", "hide", or "minimize"
Cloak is the recommended default. Windows become invisible but keep their taskbar icons, so you can still see all running apps. Clicking a cloaked window’s taskbar icon automatically switches to its workspace.
Per-Monitor Workspaces
Each monitor has its own independent set of 8 workspaces. Switching workspaces on one monitor does not affect other monitors.
Status Bar Integration
If the status bar is enabled with a workspaces widget, it displays
pill-shaped indicators showing which workspace is active and which
workspaces contain windows.