Skip to content
EN
Download

Control bar

The control bar is a bar of TilingBud’s own at an edge of a space. It shows the space’s layout, its windows, its floating windows and a few actions. It lives on its space and slides with it when you switch spaces. It stays above the other apps’ windows and never takes the focus: a click runs a command, as a shortcut would.

Rest the pointer on an item for half a second to see what it does. A right click on the bar, outside a window’s or the layout’s icon, opens TilingBud’s menu, as on the menu bar item.

Settings › Control Bar sets everything on this page and shows a preview. The keys are in [control_bar] of the configuration file.

Choose Show on Settings › Control Bar:

Choice show What it does
Docked "docked" A strip along the whole edge on every space; the windows are arranged beside it (the default)
When needed "auto" A short bar while a floating window is covered or the space is stacked
Always "always" A short bar on every space, above the windows, also with the layout off
Hide automatically "hover" Shows while the pointer is at the bar’s edge

To have no bar, set show = "off" in the file.

Edge puts the bar at the left (the default), right, top or bottom.

[control_bar]
show = "docked"
edge = "left"
size = 32

Under Settings › Control Bar › Appearance:

  • Theme: Soft, Square or Rounded, as the menu bar’s pills.
  • Size: the bar’s thickness, 24 to 56 points (32 by default).
  • Background blur: how much of the glass background shows, from 0 to 1. At 0 only the buttons stay.
  • Border: a thin line around the bar.
  • Block and Block color: parts of the Space section on a block, as on a pill.

The window in front is marked with a ring in the color of its border.

Under Settings › Control Bar › Sections, drag the sections to the start, the middle or the end of the bar. A section with nothing to show is left out.

  • Space: the space’s label. Its parts (number, symbol, name, shortcut) are set under Space Section.
  • Saved layouts: the name of the saved layout that arranges the space, while one does. A click opens the layout menu.
  • Layout: the layout’s symbol. A click opens the layout menu beside the bar.
  • Windows: an icon per arranged window, in the layout’s order, the focused one marked. A click focuses it.
  • Floating windows: an icon per floating window. A click brings it forward.
  • Shortcut mode: the shortcut mode that is on, while one is.
  • Actions: the actions below.
[control_bar]
sections = ["space", "presets", "layout", "windows", "floating"]
sections_center = ["mode"]
sections_end = ["actions"]

A click on the Layout or Saved layouts section opens the space’s layout menu: every mode with a preview of the space’s windows, then the saved layouts with their sketches. It is the same menu as Layout of This Space in the menu bar item’s menu; see Layouts and Saved layouts.

Choose and order the entries under Settings › Control Bar › Actions:

Entry actions What it does
Balance Sizes balance Gives every window an equal area
Balance Automatically auto-balance Turns automatic balancing on or off; filled with the accent color while on
Gaps gaps Inner and outer gap from 0 to 16 points, gaps off for now, or reset
Rotate & Flip arrange Rotate by 90°, 180° or 270°, mirror, or turn the split
Bring Floating Windows to Front raise-floating Raises the space’s floating windows
Overview of This Space overview Shows every window of the space to scale

The default is ["balance", "gaps", "arrange", "raise-floating", "overview"]. An entry that does not apply to the space, such as Balance Sizes on a stacked space, is disabled and says why.

Right-click a window’s icon in the Windows or Floating section for its menu: float or tile it, dock it on the left or right edge, move it to a space, minimize or close it.

Icons chooses one icon per app with a window count (the default) or one icon per window.

The Floating section lists every window the layout does not arrange: windows that float by a rule, by Float Window, because their size cannot be set, and dialogs that stand alone. On a space with the layout off, every window is listed there. Sheets and popovers are never listed.

A floating window that other windows hide by more than half is marked as covered. A click brings it to the front with the focus.

Three options on Settings › Control Bar decide what counts:

  • Covered floating windows (covered_floating): with When needed, a covered floating window brings the bar.
  • Windows assigned to all spaces (all_spaces_windows): windows of an app on all spaces count as floating windows of the space they are shown on.
  • Lists the windows of a stacked space (replaces_stack_bar): a stacked space lists its windows in the bar; with When needed it then always has one.

More on floating windows: Floating windows and rules.