Saved layouts
A saved layout remembers the arrangement of a space with places instead of windows. Each place names the app whose window belongs there. Apply the layout to a space and every window goes into its place; a place whose window is missing waits for it.
Settings › Saved Layouts lists your layouts with a sketch of their places, saves the arrangement of a space, applies a layout and edits it.
Saving a layout
Section titled “Saving a layout”Arrange a space the way you want it, in any mode but off. Then choose Save Layout… in the layout menu (the control bar’s Layout section, or Layout of This Space in the menu bar item’s menu).
A small window asks for the name and stays in front while you open and arrange more apps. An overlay marks each window’s place on the screen with its number and app.
Before saving, you can set up each place: a title pattern, the document, folder or link its window shows, start arguments, and parking (see below). The window also asks:
- whether each place keeps how its window is opened (the document or link it shows), on by default;
- whether applying the layout opens what is missing, on by default;
- whether windows that take no place float while the layout arranges the space, off by default.
From the command line:
tilingbud space --layout-save mailtilingbud space --layout-save mail --replaceApplying a layout
Section titled “Applying a layout”Pick a saved layout in the layout menu, on Settings › Saved Layouts, or run space --layout-apply mail.
The space keeps the layout from then on: it stays arranged by it after a restart, until you choose Stop Using in the layout menu or apply another one. Saving a space also makes it keep the new layout, unless you turn off “Use for this space”.
space --layout-choose opens the layout menu at the pointer; bind it, or a single layout, on Settings › Shortcuts.
Places
Section titled “Places”A window takes a place when its app matches and, if the place has a title pattern, its title matches. A place with a document or link takes the window that shows it first, so two windows of one app keep their places.
While the layout arranges a space:
- A place whose window is missing takes no area. Its window goes there when it opens.
- A window of an app with a place in the layout stays on the space, even against a rule naming another space.
- A window that opens on another space while its place waits is moved here.
When the layout opens what is missing, applying it on purpose opens a window for every free place: an app that does not run starts with the place’s document, and a running app gets a new window. Each window comes to the layout’s space.
Parking places
Section titled “Parking places”A parking place takes the newest matching window and minimizes the one that was there. Click the minimized window in the Dock and it takes the place back, parking the other. Without parking, a second window of the app joins the layout.
Other windows
Section titled “Other windows”With “other windows float” on, windows that take no place float on the space. Each appears where
float_position says and then stays where you move it. Float Window on such
a window takes it into the arrangement instead.
Rules that fill places
Section titled “Rules that fill places”A window rule can send an app’s windows into a place with slot. The place is named by its number in reading order or
by its app:
[[rule]]app = "Mail"slot = "mail.1"See Floating windows and rules.
Variants per display
Section titled “Variants per display”A layout can have several variants, each with its own mode, arrangement and places. The first variant whose condition matches the space’s display is used; a variant without a condition matches every display. The conditions are those of display profiles: the display’s name, built-in or not, its shape, its width, the number of displays.
Saving writes the variant for the current display and keeps the others. Arrange a space on the laptop, save it under the same name, and the layout has a laptop variant beside the one for the large display.
The editor on Settings › Saved Layouts also adds a variant without arranging a space there: choose the display it is for (the built-in display, a shape, or every display) and a mode.
When the displays change, every space that keeps a layout is arranged by the variant that matches its display now. When no variant matches, the space is arranged as without the layout, and Settings says so.
The layout menu
Section titled “The layout menu”The same layout menu opens from the control bar’s Layout and Saved layouts sections, from Layout of This Space in
the menu bar item’s menu, from Layout of Space N in a window’s menu, and with space --layout-choose. It holds:
- every layout mode, with a preview of the space’s windows;
- Save for This Space and Back to Saved, while the mode differs from the saved one;
- the saved layouts with their sketches, the active one checked;
- Save Layout…, Edit and Stop Using for the active layout, Edit Saved Layouts… and Layout Settings….
Removing a layout
Section titled “Removing a layout”Remove a layout on Settings › Saved Layouts.