Skip to content
EN
Download

Layouts

A layout arranges the windows of a space side by side without overlap. TilingBud keeps them arranged as windows open, close and move. The Layouts page under Getting Started shows each mode in motion.

Settings › Layout & Tiling holds the default layout, the options of each mode and the gaps. The keys are in [tiling] of the configuration file.

  • bsp (Split, the default): a new window splits the area of the focused window. A window that closes, is minimized or moves away leaves a gap that the others fill.
  • main (Main and Secondary): a main area and the other windows in a secondary area beside it. New windows join the end of the secondary area.
  • stacked: all windows lie on one frame, the focused one in front. The control bar lists them.
  • scroll: columns side by side in a row that may be wider than the screen.
  • off: TilingBud leaves the windows alone.

For every space, set the default on Settings › Layout & Tiling or in the file:

[tiling]
layout = "bsp"

For one space, click the space on Settings › Spaces and choose its layout. In the file this is the space’s [[space]] entry; Settings writes it for you:

[[space]]
name = "Mail"
layout = "main"

To switch the shown space for now, click the Layout section of the control bar or open Layout of This Space in the menu bar item’s menu. Both open the same layout menu. A mode chosen this way stays, also after a restart, until you choose Back to Saved or change the space’s saved layout. Save for This Space makes it the space’s saved layout.

By command, space --layout main sets the mode and space --layout next steps through layout_cycle (["bsp", "main", "stacked"] by default). See the command line.

Under Split on Settings › Layout & Tiling:

  • A new window goes right of or below the focused window (the default), or left of or above it (new_window_placement).
  • Split ratio: the share the existing window keeps when a new one splits its area (split_ratio, 0.5).
  • Split side by side when wider than: an area is split side by side while it is at least this many times as wide as high, else on top of each other (split_width_multiplier, 1.0). A lower value keeps windows side by side longer.

Under Main and Secondary:

  • Main area: the side of the main area. Automatic puts it left on a display wider than tall and on top otherwise (main_position).
  • Share of the main area (main_ratio, 0.5). Dragging the divider changes it for that space until TilingBud restarts.
  • Windows in the main area (main_count, 1).

Every window gets the same frame. With the control bar’s Lists the windows of a stacked space on, the bar shows an icon for each window, and a click brings one to the front. ⌥ H and ⌥ L from the recommended shortcuts go back and forth through the stack.

Each window gets a column of its own, right of the focused column. The row scrolls so the focused column is in view. Columns out of view wait at the screen edge with a narrow strip showing.

Under Scroll on Settings › Layout & Tiling:

  • New column: the width of a new column as a share of the screen (scroll_width, 0.5).
  • Column widths: the widths window --ratio next and prev step through (scroll_widths, ½, ⅔ and full).
  • Window heights: the shares window --height next and prev step through when windows share a column (scroll_heights).
  • Focus shows: Just enough scrolls as little as brings the column into view; In the middle centers it (scroll_reveal).

Two ways scroll the row under the pointer by hand. When you let go, the row eases into the nearest column edge, so no column stays cut off.

  • Swipe: a horizontal swipe with three or four fingers (scroll_swipe_fingers, off by default). Swipes with another finger count reach macOS as before. Settings warns when macOS switches spaces with the same count, and the permission window shows how to change it in System Settings.
  • Scroll wheel with a modifier key held: the wheel or two-finger scrolling scrolls the row (scroll_modifier, none by default).
[tiling]
scroll_width = 0.5
scroll_widths = [0.5, 0.667, 1.0]
scroll_swipe_fingers = 0
scroll_modifier = ""

Under Gaps:

  • Inner gaps: points between windows (inner_gap, 8).
  • Outer gaps: points between windows and the screen edges (outer_gap, 8). Per side sets each edge on its own, for example to keep room for widgets.
[tiling]
inner_gap = 8
outer_gap = [8, 320, 8, 8] # top, right, bottom, left

Each mode’s section has Own gaps that replace these for that mode only (bsp_inner_gap, scroll_outer_gap and the others).

For the shown space only, the control bar’s Gaps action sets gaps from 0 to 16 points, turns them off for now or resets them. space --toggle gaps turns them off and on again.

Balance Sizes in the control bar, or space --balance, gives every window of a bsp space an equal area. In scroll, every column gets the focused column’s width and the windows of a column equal heights.

Balance automatically under Split (auto_balance, off by default) balances a bsp space every time a window joins or leaves. A space arranged by a saved layout keeps its ratios.