Workspaces
Independent virtual desktops. Each workspace is its own infinite strip of columns. You do not need macOS Spaces.
Numbered Workspaces PRO
Numbered workspaces are made as needed:
- At least one workspace exists on each display at all times
- A workspace is made automatically when you move a window to it
- An empty workspace is removed, but only after you switch away. A workspace does not disappear when its last window closes.
- Switch workspaces with Hyper+1 through Hyper+9, or step through them one at a time with Hyper+' / Hyper+/
More than one workspace per display requires FazerWM Pro. The free tier keeps a single workspace — Workspace 1 — on each display. When Pro ends, windows from other workspaces fold into Workspace 1, and the workspace binds stop working.
Named Workspaces PRO
Persistent workspaces with custom names. The workspaces stay even when they are empty.
Named workspaces require FazerWM Pro. They appear before the numbered workspaces. You can pin them to specific displays.
Configuration
namedWorkspaces:
- name: chat
displays: [DELL U2720Q, primary]
presence: always
focus: hyper+g
moveColumn: hyper+loption+g
moveWindow: hyper+lshift+g
- name: project-x
presence: onDemand
focus: hyper+p
Presence Modes
| Mode | Behavior |
|---|---|
always | The workspace is always visible, even when it is empty |
onDemand | The workspace is made when a window rule targets it. It is removed when it is empty. |
Display Assignment
Pin a workspace to specific monitors:
- By name:
["DELL U2720Q"]matches the display name - By keyword:
["primary"]matches the primary display - By index:
[0]matches the display at that index - Multiple: The workspace appears on all the displays in the list
If you do not specify a display, the workspace appears on all displays.
Renaming
When you rename a named workspace in Settings, the window rules that reference the old name are updated automatically. They now use the new name. This prevents rules from breaking after a rename.
Dedicated Keybindings
Each named workspace can have its own shortcuts:
| Key | Action |
|---|---|
focus | Switch to this workspace |
moveColumn | Move the focused column to this workspace |
moveWindow | Move the focused window to this workspace |
Coupled Workspaces PRO
Span one workspace across all displays. When you switch workspaces, all screens change at the same time:
layout:
coupleWorkspaces: true
When the workspaces are coupled, Hyper+2 switches all displays to workspace 2. Named workspaces also sync. If a named workspace does not exist on another display, it is made there automatically. Relative stepping couples too: Hyper+' / Hyper+/ moves every display at the same time, each one step along its own workspace list.
Workspace Lifecycle
Workspace Indicator
The menu bar icon shows the workspace name or number of the display under your mouse. Named workspaces show their config name. Numbered workspaces show their 1-based index.
SketchyBar Integration
FazerWM detects SketchyBar at startup: tiled windows respect the bar height, and SketchyBar shows one item per workspace. Setup, customization, and the theme file are covered on the SketchyBar page.
Command-Line Interface
fazerwmctl controls FazerWM from the terminal or scripts — focus workspaces, create new ones. Both actions are Pro-gated. Commands, options, and how it talks to the app are on the fazerwmctl page.
Moving Between Workspaces
These actions are Pro-gated — on the free tier they are inactive, since each display keeps a single workspace:
| Shortcut | Action |
|---|---|
| Hyper+1–9 | Focus a numbered workspace |
| Hyper+' / Hyper+/ | Step to the previous / next workspace — named workspaces included |
| Hyper+LOption+1–9 | Move the column to a numbered workspace |
| Hyper+LShift+1–9 | Move the window to a numbered workspace |