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.
When and where it shows
Section titled “When and where it shows”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 = 32Appearance
Section titled “Appearance”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.
Sections
Section titled “Sections”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"]The layout menu
Section titled “The layout menu”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.
Actions
Section titled “Actions”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.
Window icons
Section titled “Window icons”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.
Floating windows
Section titled “Floating windows”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.