Menu bar
TilingBud’s item in the menu bar shows every space as a pill. Each pill holds the icons of the windows on that space. The space you are on is marked, and the focused window’s icon is larger.
- A click on a pill switches to that space.
- Resting the pointer on a pill opens the hover panel with the space’s windows.
- A right click on the item opens TilingBud’s menu.
Settings › Menu Bar sets everything on this page, with a preview. The keys are
in [menu_bar] of the configuration file.
What the item shows
Section titled “What the item shows”At the top of Settings › Menu Bar, choose what the item shows:
| Choice | show |
What you see |
|---|---|---|
| Spaces | "spaces" |
A pill for every space (the default) |
| Current Space | "current" |
Only the pill of the space each display shows |
| Symbol | "icon" |
Only TilingBud’s symbol; a click opens the menu |
| Off | "off" |
No item |
Labels
Section titled “Labels”A pill’s label is made of parts, in the order you choose under Settings › Menu Bar › Space Labels:
- Number: the space’s position on its display.
- Name: the space’s name, or its number while it has none.
- Shortcut: the keys that switch to the space, smaller and dimmed.
- Layout: a symbol for the space’s layout, or for the saved layout it keeps.
- Symbol: the space’s own SF Symbol or emoji.
Names and symbols are set per space in Settings › Spaces.
[menu_bar]label = ["number", "name"]Under Settings › Menu Bar › Icons:
- Show app icons turns the icons on or off (
show_icons). - Icons per space shows one icon per app with a window count, or one icon per window (
icon_grouping = "per_app"or"per_window"). - Highlight the focused window’s icon makes it larger and fully opaque (
highlight_active_icon). - Show windows assigned to all spaces on every pill gives such windows an icon on each space
(
show_sticky_windows). - Compact icons lets the icons overlap to save room (
compact_icons).
Window title
Section titled “Window title”Show the focused window’s title puts the title on the pill of the space you are on, after its icons
(show_window_title, off by default). Title width is the room the title always takes, 60 to 400 points, so the
menu bar does not move when the title changes. Longer titles are cut.
Themes
Section titled “Themes”Under Settings › Menu Bar › Appearance:
- Theme: Soft (slightly rounded corners, the default), Square or Rounded (round ends). The fills follow the menu bar’s light or dark look.
- Segments: the pills of a display become segments of one bar, with a divider between two.
- Block: parts of the label sit on a block at the pill’s left edge. Choose the first part, every part, the whole pill, or none.
- Block color: Automatic follows the look; the accent color or a color of your own also work.
[menu_bar]theme = "soft"segmented = falselabel_block = "first"block_color = "auto"Several displays
Section titled “Several displays”With more than one display, choose under Settings › Menu Bar › Display:
- Each display its own spaces (
displays = "own", the default): every menu bar shows the spaces of its display. Where macOS does not allow that, TilingBud shows the spaces of the display with the focused window, and Settings says so. - Spaces of the active display (
"active"): every menu bar shows the spaces of the display with the focused window. - All displays, grouped (
"all"): every menu bar shows all spaces, grouped by display with a separator.
Shrink on narrow displays (auto_shrink, on by default) makes the pills smaller step by step on a display whose
menu bar has too little room, instead of macOS hiding the item there. They grow back once the larger pills fit.
The hover panel
Section titled “The hover panel”Rest the pointer on a pill and a list of the space’s windows opens below it. On a space that keeps a saved layout, the panel names that layout.
- A click on a window row focuses the window and shows its space.
- A right click on a row opens the window’s menu: move it to a space (staying, following it, or with all windows of its app), Float Window or Tile Window, Layout of Space N, and Rule for the app (“Rule for Slack…”), which opens a new rule for the app in Settings › Apps.
Window list width sets how wide the panel may get, 200 to 600 points (hover_panel_width).
The menu
Section titled “The menu”A right click on the item opens TilingBud’s menu. It always holds:
- Settings…
- Layout of This Space: the layout menu of the shown space, with its modes and saved layouts. While a saved layout arranges the space, the entry reads “Layout:” and the layout’s name. See Saved layouts.
- Apply Window Rules Now: applies the window rules to every open window.
- Quit TilingBud
Some entries appear only while you need to act: Install Command Line Tool…, Set Up Missing Permissions…, the number of problems in the configuration file, and the number of features not available on this Mac. While a shortcut mode is on, the menu also offers to leave it.
An entry shows a key combination only when one of your shortcuts runs its command.