Recent Windows
Settings → Recent Windows: enable the Alt+Tab-style switcher, shape its grid, style its highlight, and bind its keys.
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.
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
| Key | Action |
|---|---|
| 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 / A | Select first, or scope: All |
| End / W | Select last, or scope: Workspace |
| S | Open search |
| O | Scope: Output (the current display) |
| Esc | Cancel (return to the original window) |
| Return | Select the focused window (confirm) |
| Release modifiers | Confirm the selection |
Scopes
| Scope | Windows shown |
|---|---|
all | All windows across all displays and all workspaces |
output | Only windows on the current display |
workspace | Only windows on the current workspace |
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:
| Shortcut | Action |
|---|---|
| ⌘+Tab / ⌘+⇧+Tab | Next / previous window |
| ⌘+` / ⌘+⇧+` | Next / previous window of the same app |
- Either Command key works, and the switcher stays open while you hold it, exactly as it does with Option.
- It replaces the macOS app switcher while FazerWM runs. FazerWM hands ⌘Tab, ⌘⇧Tab and ⌘` back to macOS when you turn the setting off, disable the switcher, quit FazerWM, or revoke its Accessibility permission. If FazerWM ever crashes while holding them, they come back the next time it launches.
- Your Option keybinds are kept but not used while this is on; the Keybinds rows are dimmed. Turn it off and they apply again.
- Pro: on the free tier the setting is ignored, the Option keybinds apply, and ⌘Tab stays with macOS.
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.
Search
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
| Control | Default | What it does | Config key |
|---|---|---|---|
| Enable recent windows switcher | on | Master switch. Disabling frees the Option+Tab keybinds for other apps (focus tracking keeps running). | recentWindows.enabled |
| Columns | 8 | Grid width of the switcher. Slider 0–15; 0 = Auto, sized to the display width. | recentWindows.columns |
| Show app icon PRO | on | Show 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 | #9CFDBA | Outline color of the selected thumbnail. | recentWindows.highlight.colorActive |
| Outline width | 1 px | Thickness of that outline. Slider 1–10. | recentWindows.highlight.outlineWidth |
| Use ⌘Tab and ⌘` for this switcher PRO | off | Bind 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 window | loption+tab | Step forward through the MRU list. | binds.recentWindowNext |
| Previous window | loption+lshift+tab | Step backward through the MRU list. | binds.recentWindowPrevious |
| Next (same app) | loption+grave | Step forward within the focused app's windows. | binds.recentWindowSameAppNext |
| Previous (same app) | loption+lshift+grave | Step 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