The Recent Windows pane
Enable
Enable recent windows switcher
Grid
Columns8
Cards PRO
Show app icon
Highlight
Active color
Outline width1 px
macOS Switcher PRO
Use ⌘Tab and ⌘` for this switcher
Replaces the macOS app switcher while FazerWM runs: ⌘Tab / ⌘⇧Tab step through windows, ⌘` / ⌘⇧` through the current app's. macOS gets them back when FazerWM quits.
Keybinds
Next windowloption+tabRecord✕
Previous windowloption+lshift+tabRecord✕
Next (same app)loption+graveRecord✕
Previous (same app)loption+lshift+graveRecord✕

Everything below the Enable toggle dims when the switcher is off. This pane is free for everyone except the Cards group (app icons) and the macOS Switcher group (⌘Tab takeover), which are Pro.

How the switcher works

The switcher tracks window focus in MRU (most recently used) order: every window that gains focus moves to the front of the list, and closed windows are pruned from it. An app's native tab group (Safari, Ghostty, Mail) appears once, as its current tab. Thumbnails refresh about once a second while the switcher is open. Each card shows a live thumbnail with the app name and window title beneath it, plus the app icon on Pro.

Minimized and fullscreen windows are listed too, marked with a small icon on their card. Choosing a minimized window restores it as a new column after the focused window (see Minimizing Windows); choosing a fullscreen window focuses it and it expands over its display.

Switcher Overlay
⌨️ Holding the modifier

The switcher stays open only while you hold the bound modifier (Option by default). When you release it, the current selection is confirmed and the overlay closes. After you press S to open search, the overlay stays open even after you release the modifier. Type freely, confirm with Return.

While the switcher is open

KeyAction
Tab / →Next window
LShift+Tab / ←Previous window
` (grave)Next window of the same app
LShift+`Previous window of the same app
↑ / ↓Navigate the grid rows
Home / ASelect first, or scope: All
End / WSelect last, or scope: Workspace
SOpen search
OScope: Output (the current display)
EscCancel (return to the original window)
ReturnSelect the focused window (confirm)
Release modifiersConfirm the selection

Scopes

ScopeWindows shown
allAll windows across all displays and all workspaces
outputOnly windows on the current display
workspaceOnly windows on the current workspace
ℹ️ Single display

When only one display is connected, the Output scope is hidden automatically: it is removed from the scope bar and from the keyboard shortcuts.

Use ⌘Tab instead of Option+Tab PRO

Turn on Use ⌘Tab and ⌘` for this switcher to open FazerWM's switcher with the shortcuts you already use for the macOS one:

ShortcutAction
⌘+Tab / ⌘+⇧+TabNext / previous window
⌘+` / ⌘+⇧+`Next / previous window of the same app
ℹ️ Password fields

While a password field has focus, macOS stops sending key presses to apps like FazerWM. With this setting on, ⌘Tab does nothing until you leave the field. Other ⌘Tab replacements behave the same way.

Press S while the switcher is open to activate the search bar. Type to filter the visible thumbnails by app name, window title, or bundle ID; results filter as you type (case-insensitive). Navigate with the arrow keys, confirm with Return, or exit search with Esc (the overlay stays open). The overlay also ignores modifier release while you type.

Controls

ControlDefaultWhat it doesConfig key
Enable recent windows switcheronMaster switch. Disabling frees the Option+Tab keybinds for other apps (focus tracking keeps running).recentWindows.enabled
Columns8Grid width of the switcher. Slider 0–15; 0 = Auto, sized to the display width.recentWindows.columns
Show app icon PROonShow the app icon next to the app name under each card. Off on the free tier; your setting is kept for when you upgrade.recentWindows.showAppIcon
Active color#9CFDBAOutline color of the selected thumbnail.recentWindows.highlight.colorActive
Outline width1 pxThickness of that outline. Slider 1–10.recentWindows.highlight.outlineWidth
Use ⌘Tab and ⌘` for this switcher PROoffBind the switcher to ⌘Tab / ⌘⇧Tab / ⌘` / ⌘⇧` (either Command key) instead of the four keybinds below, taking those shortcuts over from the macOS app switcher. See Use ⌘Tab instead of Option+Tab.recentWindows.useCommandTab
Next windowloption+tabStep forward through the MRU list.binds.recentWindowNext
Previous windowloption+lshift+tabStep backward through the MRU list.binds.recentWindowPrevious
Next (same app)loption+graveStep forward within the focused app's windows.binds.recentWindowSameAppNext
Previous (same app)loption+lshift+graveStep backward within the focused app's windows.binds.recentWindowSameAppPrevious

These four keybinds are the deliberate exception to the Hyper-key grammar: they mirror macOS ⌘+Tab muscle memory on Option+Tab, leaving ⌘Tab to macOS unless you turn on the ⌘Tab takeover. LShift+Tab alone is never bound by FazerWM so reverse focus traversal always reaches your apps.

YAML equivalent

recentWindows:
  enabled: true
  columns: 8                # 0 = auto-size to the display width
  showAppIcon: true         # app icon beside the name under each card (Pro)
  useCommandTab: false      # Pro: ⌘Tab / ⌘` replace the binds below
  highlight:
    colorActive: '#9CFDBA'
    outlineWidth: 1

binds:
  recentWindowNext: loption+tab
  recentWindowPrevious: loption+lshift+tab
  recentWindowSameAppNext: loption+grave
  recentWindowSameAppPrevious: loption+lshift+grave