Spaces and displays
TilingBud works with the spaces of macOS’s Mission Control. It does not make spaces of its own: names, layouts and rules stay with each space, wherever macOS puts it.
Settings › Spaces shows the spaces of every display as Mission Control does. Click a space for its name, symbol, layout, display and removal.
Switching spaces
Section titled “Switching spaces”- Click a pill in the menu bar.
- Press ⌃ 1 to ⌃ 0 for spaces 1 to 10 (bound at the first start).
- Swipe with the trackpad as usual.
By command, space --focus 3 shows space 3, space --focus next the one to the right and space --focus recent the
one shown before (command line).
Numbers in shortcuts and commands count over all displays in Mission Control’s order: with ten spaces on the main
display, space 11 is the first space of the second display. Pills number the spaces per display. Numbers shift when
macOS moves spaces between displays; a name stays with its space, so space --focus Mail always finds the same one.
Names and symbols
Section titled “Names and symbols”Give a space a name and a symbol on Settings › Spaces. The symbol is an SF Symbol or one emoji. Both show in the menu bar where the label has them; see Menu bar.
[[space]]name = "Finance"icon = "eurosign.circle"Settings writes the space’s id into the entry for you. space --label Finance names the shown space.
Adding and removing spaces
Section titled “Adding and removing spaces”On Settings › Spaces, Add Space adds a space at the end of a display, and Remove Space… removes one. The windows of a removed space move to a neighboring space, and the spaces after it move down by one number, keeping their names and layouts. A display keeps at least one space.
By command: space --create and space --destroy 4. TilingBud does this through Mission Control.
Moving windows to other spaces
Section titled “Moving windows to other spaces”- ⌃ ⌥ and a number moves the focused window to that space.
- ⌃ ⌥ ⇧ and a number moves it and goes along.
- Right-click a window in the hover panel or its icon in the control bar and choose a space.
By command, window --space 3 moves the focused window, --follow shows the space with the window focused, and
--app moves every window of its app. Without following, the focus stays on the space the window left.
To send an app’s windows to a space every time they open, use a rule
with space.
Several displays
Section titled “Several displays”Each display has its own spaces, its own pills in its menu bar and its own control bar. The focus goes on to the next display when no window lies further in that direction.
display --focus nextfocuses the next display.window --display nextmoves the focused window to the space shown on the next display.window --space 1 --display nextmoves it to the first space of the next display.
Pointer follows the focus to another display under Settings › Spaces › Focus moves the pointer along when the focus changes display; see Keyboard and mouse.
A display for each space
Section titled “A display for each space”A space can belong on a display. Choose it on Settings › Spaces, or set display in its entry: a display’s name,
"main", or a list tried in order.
[[space]]name = "Music"display = ["SAMSUNG", "main"]When you unplug a display, macOS gathers its spaces on the remaining one. When the display returns, TilingBud moves
each space back to its display and removes the empty space macOS gave the display, if it has no windows and no entry.
Without display, a space stays where macOS puts it.
Stand-in first spaces
Section titled “Stand-in first spaces”When a display goes away, macOS removes its first space and puts that space’s windows on the main display’s first
space. With Stand in for the first space under Settings › Spaces › When a Display Is Unplugged
(stand_in_first_spaces, off by default), TilingBud adds a stand-in space on the main display with the same name,
layout and windows, before the display’s other spaces. When the display returns and macOS takes the windows back, the
stand-in is removed.
Display profiles
Section titled “Display profiles”A display profile gives a display, or a setup of displays, values of its own: a smaller gap on the laptop, a simpler layout on an iPad, a narrower title in its menu bar.
On the pages Menu Bar, Control Bar, Borders and Layout & Tiling, choose a connected display under Applies To at the top. The page then shows the values on that display, marks those it takes from all displays, and writes a change into that display’s own profile. The reset arrow takes a value back out of it. Settings › Displays lists the connected displays with the profiles that apply to each.
Profiles for a setup of displays or other conditions are [[display_profile]] entries in the file:
[[display_profile]]name = "laptop alone"when.builtin = truewhen.displays = 1tiling.inner_gap = 2all_spaces.layout = "stacked"A condition can name the display, its kind (built-in, external, Sidecar, AirPlay), its shape, width, scale or size, the number of displays, or displays that must be connected. When several profiles match, the last one in the file wins per key. Nothing is written back: when the display changes, its own values return at once.
All conditions and keys are in the reference.