Workspace Model

Numbered Workspaces PRO

Numbered workspaces are made as needed:

PRO Feature

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.

PRO Feature

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

ModeBehavior
alwaysThe workspace is always visible, even when it is empty
onDemandThe workspace is made when a window rule targets it. It is removed when it is empty.

Display Assignment

Pin a workspace to specific monitors:

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:

KeyAction
focusSwitch to this workspace
moveColumnMove the focused column to this workspace
moveWindowMove 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

Numbered Workspace Lifecycle
Empty Window moved in Active workspace ← Last window removed, then user switches away → workspace removed

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:

ShortcutAction
Hyper+1–9Focus a numbered workspace
Hyper+' / Hyper+/Step to the previous / next workspace — named workspaces included
Hyper+LOption+1–9Move the column to a numbered workspace
Hyper+LShift+1–9Move the window to a numbered workspace