Scrollable Column Tiling
The core layout model: an infinite horizontal strip of columns. Each column contains windows that stack vertically.
With the default width, two columns are visible at once on a 16:9 display (wider displays show more). When you focus an off-screen column, it snaps into view with no animation. The focused column is always on screen.
How It Works
The FazerWM layout is different from the traditional macOS window management:
- Infinite horizontal strip: The columns extend left and right without a limit. Off-screen windows are parked at virtual coordinates (for example, x = -20000 to +20000). This uses the macOS Accessibility API.
- Column stacking: A column can hold more than one window. The windows are stacked vertically, or they are put in tabs. Stacked windows share the full width of the column, from top to bottom. The heights are equal or proportional. Tabbed windows share one space, and only the active tab is visible. See Tabbed Columns.
- Focused column is always visible: When you focus a column, the viewport scrolls so that the column is on screen.
- Automatic tiling: New windows are placed in a new column after the focused column. You do not have to arrange them manually.
Native Tab Groups
macOS lets you merge windows of the same app into one tabbed frame (Ghostty and Terminal are common examples). FazerWM counts such a group as a single window: it takes one column with one width, and it scrolls, moves, and parks as a unit. Only windows that really share one tab bar are grouped: separate windows of an app that merely overlap are never mistaken for tabs of each other.
FazerWM follows the tab that is showing. Focus, the Overview and Recent Windows all use the frontmost tab (Recent Windows lists the group once, as that tab), and leaving a workspace parks the visible tab. To change tabs, use the app's own shortcuts or click its tab bar; FazerWM's keyboard navigation does not step through hidden tabs.
- Switching tabs inside the app leaves the layout untouched — same column, same width, no reshuffle.
- The group is never split. Moving it to another workspace or display carries every tab, and display changes keep it together.
- A parked group shows as one thumbnail in the parked overlay; clicking it restores the group with the tab that was active.
This is the macOS-level tabbing of separate windows, not the tabbed stacking FazerWM builds inside a column — see Tabbed Columns for that.
Focus Behavior
Controls where the focused window lands when the focus changes. This is the Focused window location setting in Settings. PRO
| Mode | Behavior |
|---|---|
keepInView: Keep in View | A visible column stays where it is; an off-screen column scrolls the minimum needed to reveal it at the nearest edge (default) |
center | The focused column is always centered on screen |
layout:
focusBehaviour: keepInView
The center option requires FazerWM Pro. The free tier uses keepInView only.
Session toggle: Hyper+C (default) switches the session between the two modes without changing the saved setting. Press it once to act as if the other mode were configured; press it again to return to the configured mode.
Returning to Keep in View redraws immediately. Any blank strip Center left behind is closed: the focused window snaps flush to the left edge when it and the following columns can fill the display, or flush to the right edge when the preceding columns can fill it instead. Changing the saved setting in Settings clears the toggle.
Gaps
Set the spacing between all windows and the screen edges:
layout:
gaps: 6 # pixels between all windows, columns, and screen edges
The inner gaps (between windows) and the outer gaps (screen edges) both use this value. The default value is 6.
Default Window Width
Set the width for new tiled windows. The value takes one of three forms:
layout:
defaultWindowWidth: 2x # 2 windows across on a 16:9 display (default)
# defaultWindowWidth: 50% # Fraction of the display width
# defaultWindowWidth: 900pt # Fixed width in points
- Percentage (
50%): a fraction of the display's tiled width. The same value resolves wider on a wider display. - Across (
2x): the width is sized so that many windows fit side by side on a standard 16:9 display. Wider displays resolve the same setting to more columns: a 21:9 ultrawide gives three columns for2x, a 32:9 display gives four. The width is anchored to the display height, so it stays sensible across mixed setups. - Points (
900pt): a fixed width in logical points, clamped to the display width. The same width on every display.
Changing this setting resizes existing windows that use the default width. Columns you sized by hand, and windows whose width comes from a rule, keep their width. In Settings, the value is a mode picker (across, %, pt) with a preview of the resulting width on each connected display.
Column Width Steps
Change the width of a column with the shrink and grow shortcuts. Use Hyper+LOption+- to shrink. Use Hyper+LOption+= to grow. Each press moves the focused column through four fixed steps. The steps are 25%, 50%, 75%, and 100% (full width) of the tiled area. The column then remembers the width that you select. See Resizing.
Toggle Full-Width
Press Hyper+F to toggle the focused column between its current width and the full width. The column expands to fill the whole tiled area. The other columns scroll off to the side. The previous width is saved. It is restored when you toggle back.
Monocle Mode
Press Hyper+M (or the pinch gesture PRO) to give the focused column the whole tiled area. It is centred, with your gaps, the menu bar and any status bar respected, and every other column is parked out of sight. Focusing another window swaps which column fills the screen. Press the key again and the layout returns exactly as it was.
Monocle makes the focused column fill the tiled area while it stays an ordinary tile on the same Space, so switching workspaces, the Overview, Recent Windows and every keybinding keep working, and the change is instant. See Fullscreen Windows for FazerWM's whole-display fullscreen.
Focus After Close PRO
Control what happens to the focus when a window closes:
layout:
focusAfterClose: stayOnWorkspace # default (Pro)
# focusAfterClose: "lastFocused"
The focusAfterClose setting requires FazerWM Pro. The default value is stayOnWorkspace. On the free tier, the value is set to lastFocused.
New Windows Follow Mouse
New windows appear on the display where the mouse is:
layout:
newWindowsFollowMouse: true # default
Window Parking
Windows that are not visible are parked. They are placed 1 pixel inside a screen corner. This keeps them open but invisible. The reasons are:
| Reason | Description |
|---|---|
| Screen Overlap | The column is partially visible on another display |
| Scrolled Off | The column is scrolled off the current viewport |
| Wrong Workspace | The window belongs to a different workspace |
| User Hidden | The user turned off the visibility of tiled windows |
Fixed-Size Windows
Some windows can't be resized at all, for example balenaEtcher and some installers and utilities. FazerWM notices this and lays them out at their real size instead of stretching them to the column. The column is as wide as the window. In the normal layout the window sits at the top of its column, like any tiled window; in monocle mode it's centered. In a stacked column it keeps its height, and the space below it stays empty.
Minimizing Windows
FazerWM does its own minimize. Press the yellow button, double-click a title bar (when macOS is set to minimize on double-click), or press ⌘+M and the window leaves the layout instantly: no genie or scale animation and no Dock thumbnail. Its column closes up and the neighbouring columns slide together. The window is parked out of sight, and it keeps no reserved slot.
This works for tiled and floating windows alike. A window whose minimize button is disabled is left alone, a native tab group minimizes as one window, and a window FazerWM doesn't manage (a panel, for example) still gets the macOS minimize so ⌘+M never goes dead. The bind is windowMinimize: unbind it and ⌘+M goes back to macOS. See Keybindings.
Restoring a minimized window
A restored window comes back as a new column right after the focused window, on the display and workspace you are working on, and takes focus (the viewport scrolls to it). It does not return to the slot it left. A floating window returns to the frame it left from. You can restore from:
- the Recent Windows switcher, where minimized windows carry a small minimize badge,
- the Overview, where minimized windows are docked along the bottom edge,
- activating the app from the Dock or the ⌘+Tab switcher.
Minimized windows are remembered across restarts with session restore PRO, and are listed in the Overview and Recent Windows like any other window. A window that macOS itself minimized before FazerWM started stays minimized too.
Because FazerWM parks the window itself instead of handing it to the Dock, minimizing and restoring are instant. Only a minimize FazerWM doesn't manage (an unmanaged window, or a window restored from a macOS-side minimize) still uses the macOS animation.
Where focus goes
When you minimize the focused window, focus passes to another window the same way it does when a window closes: see Focus After Close. By default that is the most recently used window on the same workspace, otherwise the column that slid into its place. Minimizing a window that does not have focus leaves focus where it is.
Other ways to put a window away
| To do this | Use |
|---|---|
| Put a window away for later PRO | Move it to another workspace. Press Hyper+LShift+1…9 for a numbered workspace, or the Move window key of a named workspace (for example Hyper+LShift+W). Unlike a minimized window, it keeps its place in that workspace's columns. |
| Clear the screen for a moment | Press Hyper+Z to hide all tiled windows. Press it again to restore them in place. |
| Get back to a window quickly | Use the Recent Windows switcher (LOption+Tab) or the Overview (Hyper+Tab). Both show windows on every workspace. |
Moving windows between workspaces requires FazerWM Pro. The free tier keeps one workspace per display, so Hyper+Z and minimizing are the free ways to clear the screen.
Fullscreen Windows
FazerWM has its own fullscreen. It is a state of the window inside the layout, not a macOS Space: no slide animation, no separate desktop, and every keybinding, the Overview and Recent Windows keep working. Toggle it with the green button, ⌃+⌘+F (windowFullscreenToggle), or the app's View > Enter Full Screen menu item. FazerWM also takes the other ways a window can fill the display (double-clicking the title bar when macOS is set to zoom, Window > Zoom, window tools) and treats them the same way.
- It keeps its seat. The window stays in its column. While it is focused it expands over the display's visible area and the other windows on that display are parked behind it. Move focus away and it rests at that size behind a placeholder in its seat; return and it expands again. Leaving fullscreen puts it back as an ordinary tile in the same seat.
- Native fullscreen is converted. A window that enters macOS native fullscreen, or is already in it when FazerWM starts, is taken out of it and given a FazerWM fullscreen seat instead. Option-click on the green button keeps the app's own zoom behaviour.
- Tabs and stacks. A native tab group shares one fullscreen state across its tabs. In a FazerWM-tabbed column a fullscreen tab holds its fullscreen only while it is the active tab; switching away returns it to its tiled size, and its tab shows a fullscreen badge. No focus ring is drawn on or around a fullscreen window.
- It is listed everywhere. The Overview shows the placeholder in its seat, and the Recent Windows switcher marks its card with a fullscreen icon.
- It survives restarts. Session restore PRO brings fullscreen windows back to their seat.
- Disabled buttons are respected. If an app disables its green button, the click and the bind do nothing when entering fullscreen. Leaving is always allowed.
Zoom for floating windows
On a floating window, the green button and the fullscreen bind zoom it into the tiling: it joins the layout as a maximised column beside the focused one. Zoom it again and it floats back at the frame it had before.
If you want one column to fill the tiled area while the others stay one keystroke away, monocle mode (Hyper+M) does that without changing any window's state. Fullscreen covers the whole display, menu-bar area included.
PRO A rule that sets a window's geometry no longer blocks the green button. Fullscreen doesn't change the window's rule geometry, so the window returns to it when it leaves fullscreen. The rule's workspace and display still apply.
Floating Windows
Not every window belongs in the tiling grid. Floating windows are left out of the layout: they keep their own size and position and stack like ordinary macOS windows (there is no separate "floating layer"). A window floats for one of three reasons: the source app already defines it as floating (dialogs, accessory apps, elevated windows; automatic and free on every tier), a window rule floats it explicitly, or — on the free tier — the tiling cap is reached: the first 8 tiled windows occupy the slots and anything beyond that floats where macOS put it (closing a tiled window frees its slot, and the oldest overflow window tiles into it). There is no hotkey to float the focused window on the fly.
Press Hyper+Z to hide all tiled windows and see only the floating ones, the same "User Hidden" parking state as above. Press it again to restore.
Every window is in exactly one of four states:
| State | Description |
|---|---|
default | Normal tiled window |
tiled | Vertically tiled in a column |
tabbed | In a tabbed column |
float | Floating (not tiled); keeps its own size and position |
To float a window explicitly, declare it with a window rule. The built-in auto-float cases are free on every tier, while rule-based floating is part of Window Rules (Pro).