Session Restore PRO
Quit, update, restart or log out. When you are back, your windows come back where they were: the same display, workspace, column and focus.
Session restore requires FazerWM Pro (including the trial). On the free tier FazerWM saves and restores nothing: windows are tiled as new windows at every launch.
What It Does
FazerWM keeps a record of your layout as you work. The next time it starts, it puts everything back before you have to touch a window:
- Displays and workspaces: each window returns to its display and workspace, and each display to the workspace it was showing. Named and numbered workspaces are created as needed.
- Columns: columns come back in order, with stacked and tabbed columns regrouped and each column's active tab restored.
- Sizes and positions: columns whose width you set by hand keep it, floating windows go back to their saved frames, and each workspace is scrolled to where you left it.
- Focus: the window you were working in gets focus again (with the pointer following it, according to Pointer follows focus).
- Fullscreen and minimized windows: fullscreen windows return to their seat, and the Recent Windows list comes back in order, minimized windows included.
Three Situations
FazerWM restarts
After an update, a quit or a crash, your apps are still running, so every window is matched exactly and the layout is back in the first moments after launch.
After a reboot or a logout
Your apps have to reopen their windows first. When macOS reopens them for you (the Reopen windows when logging back in choice in the restart and shut down dialogs), FazerWM waits for them and places each one as it appears:
- A Restoring your layout panel on every display shows how many windows are back, for up to a minute.
- A window whose app was relaunched is matched by the app and the exact window title. A window whose title changed since it was saved (a second Mail window, for instance) is still matched to its saved spot rather than placed like a new window. If the app had just one saved window, its one new window is matched whatever its title. Anything ambiguous is placed like a new window, after the focused column, so nothing lands in the wrong slot.
- The saved focus is applied once, when the focused window is back.
FazerWM can only arrange windows that exist. If an app does not reopen its windows after a login, they are not part of the restored layout.
Different displays
Every display setup you use has its own saved layout.
- Same displays as last time: that setup's own layout is restored.
- Different displays: the most recent layout is re-expressed for what is connected, the way a display change relocates windows. The main display's windows go to the main display; other displays are matched to the connected ones by native resolution, with position breaking ties; displays that end up together are merged workspace by workspace.
- Plugging a known setup back in: once the displays settle, its saved layout is re-applied, so windows move back to the display they were on. A window you moved by hand since that layout was saved is left where you put it.
See Display Hotplug for how live display changes work between restarts.
How It Behaves
- Saving: a couple of seconds after the layout changes, and again at quit. Nothing is saved while the screen is locked, while windows are briefly missing, while a display change is settling, or while a restore is still in progress.
- Restarts and shutdowns: when you log out, restart or shut down, apps close their windows one by one. FazerWM holds its saves so the half-closed layout never replaces the whole one.
- Window rules win: a window matched by a rule is placed by its rule, and a column grouped by a rule or by an app's native tabs stays together.
- New windows: windows that were not in the saved layout get their own columns after the restored ones.
- Retention: all your display setups are kept; a setup you have not used for 30 days is dropped.
The layout lives in ~/Library/Application Support/FazerWM/session.json on your Mac. It holds window titles, app identifiers and positions, and it is never sent anywhere. Delete the file (with FazerWM quit) to start fresh at the next launch.
Free Tier
FazerWM does not save or restore a session on the free tier, and it ignores any session file left over from a trial. Display-setup memory still works while FazerWM is running (it remembers the last 2 setups); it simply does not survive a quit or restart. See Pro & Licensing for the full comparison.