Setup Assistant

On first launch, FazerWM shows a Setup Assistant. The assistant guides you through the steps. The window manager starts only after these steps.

Setup Flow
1 Activate Server registration (trial start) 2 Configure the Hyper Key Caps Lock → Hyper (Karabiner-Elements) 3 Configure Desktop & Dock Separate Spaces, disable macOS tiling 4 Configure Trackpad Gestures Free up 3- & 4-finger swipes 5 Choose Your Keybinding Scheme Arrows, Vi or Emacs — written to config.yaml 6 Grant Permissions Device Control and Data Access first, then Screen & System Audio Recording macOS restarts the app to apply the last grant Ready! Start tiling

Step 1: Activation

FazerWM registers your device to start the free Pro trial. This step runs in the background.

Step 2: Configure the Hyper Key

FazerWM shortcuts use a Hyper key. By default, the Hyper key is Right Shift + Right Option. No other app uses this combination, so it does not conflict with other shortcuts. A single physical key cannot make this combination. The assistant remaps Caps Lock through Karabiner-Elements. Karabiner-Elements is a free, open-source tool. Hold Caps Lock to use Hyper. Tap Caps Lock to use the normal Caps Lock function.

The step shows a live checklist. The checklist shows Karabiner installed, Karabiner running, and the Hyper rule configured. The checklist updates as you go. A one-click Add to Karabiner button writes the rule into your config. The assistant warns you if Caps Lock is already mapped to another function. This step is recommended, but it is optional.

Step 3: Configure Desktop & Dock

This step covers two groups of System Settings. Go to Desktop & Dock. Each group has a one-click button in the assistant:

Displays have separate Spaces. FazerWM manages its own workspaces. It does not use macOS Spaces to organize your windows. This macOS setting gives each monitor its own Space. The setting prevents conflicts and gives the cleanest behavior for each display. FazerWM works best with this setting enabled. The setting takes effect only after you log out and log in again. The assistant Enable button turns the setting on if it is off.

Disable macOS window behaviours. The macOS window tiling and the Mission Control drag-to-top gesture conflict with the FazerWM layout. The assistant Disable All button turns off:

Step 4: Configure Trackpad Gestures

To use 3-finger and 4-finger swipes, turn off the macOS gestures that conflict. These gestures are Swipe between full-screen apps, Mission Control, and App Exposé. Open System Settings. Go to Trackpad, then More Gestures. The assistant detects the conflicts automatically.

Step 5: Choose Your Keybinding Scheme

Commands with a direction (focus, move column, move window, extract) can use the arrow cluster or a letter scheme. The assistant shows a card for each preset — Default (arrow keys), Vi (HJKL), and Emacs (BNPF) — with an example key for each. Everything else is identical between the presets. The choice is written to ~/.config/FazerWM/config.yaml, and you can change it any time by editing that file.

Step 6: Grant Permissions

FazerWM needs two permissions. They are requested in one step, in order:

Device Control and Data Access (called Accessibility on macOS 26 and earlier): needed to manage windows and to capture keyboard events. Without it, FazerWM cannot function. The assistant opens System Settings to this pane. Turn FazerWM on. The assistant detects the grant automatically and continues. The permission itself is the same on every version.

Screen & System Audio Recording: needed to show live previews of your windows in the Overview, the Recent Windows switcher, parked windows, tab hover previews, and window drags. FazerWM captures the previews at thumbnail size. It keeps them in memory only, and it never saves or sends them. It never captures audio. The assistant explains this permission from the start, but you can request it only after you grant Device Control and Data Access. When you grant it, macOS presents its own quit-and-reopen dialogue. Accept it, and on the relaunch FazerWM finds both permissions granted and starts without the wizard.

The Finish button stays disabled until both permissions are granted.

After Setup

When the setup is complete, the Setup Assistant closes. The full window manager starts:

Menu Bar

FazerWM runs from the menu bar. Click the menu bar icon to open these items:

Menu ItemDescription
Upgrade to Pro...Opens the purchase page. This item shows only during the trial or in the free tier.
Debug PanelShows the internal state for troubleshooting
SettingsOpens the Settings window (⌘+,)
QuitQuits FazerWM and moves all windows back to visible positions
💡 On Quit

When FazerWM quits, it moves all managed windows back on screen. Windows that were parked move back to visible positions. Parked windows are windows that were scrolled out of view or on a different workspace. No windows are lost.

Your First Steps

After the setup, do these actions:

1

Open a few windows

Open Terminal, a browser, or any app. The windows tile into columns automatically.

2

Navigate with the Hyper key

Hold RShift+ROpt (the Hyper key). Press ← or → to move the focus between windows and columns.

3

Switch workspaces

Press Hyper+1 to go to workspace 1. Press Hyper+2 to go to workspace 2.

4

Open the Overview

Press Hyper+Tab to see all workspaces.