How Column Tiling Works
Slack
VS Code
Browser
Messages
Notes
Finder

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.

Visible screen area
Focused window
Off-screen (parked)

How It Works

The FazerWM layout is different from the traditional macOS window management:

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.

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

ModeBehavior
keepInView: Keep in ViewA visible column stays where it is; an off-screen column scrolls the minimum needed to reveal it at the nearest edge (default)
centerThe focused column is always centered on screen
layout:
  focusBehaviour: keepInView
PRO Feature

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

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"
PRO Feature

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:

ReasonDescription
Screen OverlapThe column is partially visible on another display
Scrolled OffThe column is scrolled off the current viewport
Wrong WorkspaceThe window belongs to a different workspace
User HiddenThe 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:

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.

No animation

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 thisUse
Put a window away for later PROMove 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 momentPress Hyper+Z to hide all tiled windows. Press it again to restore them in place.
Get back to a window quicklyUse the Recent Windows switcher (LOption+Tab) or the Overview (Hyper+Tab). Both show windows on every workspace.
PRO Feature

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.

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.

💡 Monocle is the alternative

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.

Window rules and fullscreen

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.

Seeing Floating Windows
Normal
Floating
Hyper+Z hide tiled
Tiled hidden
Floating

Every window is in exactly one of four states:

StateDescription
defaultNormal tiled window
tiledVertically tiled in a column
tabbedIn a tabbed column
floatFloating (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).