Skip to content
EN
Download

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.

  • 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.

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.

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.

  • ⌃ ⌥ 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.

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 next focuses the next display.
  • window --display next moves the focused window to the space shown on the next display.
  • window --space 1 --display next moves 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 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.

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.

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 = true
when.displays = 1
tiling.inner_gap = 2
all_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.