Floating windows and rules
A floating window is one the layout does not arrange. It stays where you put it, and the layout never moves it. The other windows of the space share the area without it.
Floating a window
Section titled “Floating a window”⌥ T takes the focused window out of the layout, and pressing it again puts the window back. The
same is Float Window and Tile Window in a window’s menu: right-click its row in the menu bar’s hover panel or
its icon in the control bar. By command it is window --toggle float
(command line).
A floated window stays floating until it closes. To float every window of an app, use a rule (below).
Where a floated window lies
Section titled “Where a floated window lies”A window taken out lies under Settings › Layout & Tiling › Taking a Window Out:
| Choice | float_position |
Where |
|---|---|---|
| In the middle, half the width | "center" |
The middle half of the screen, nearly full height (the default) |
| Where it was | "stay" |
Where the layout had it |
| Where it floated last | "last" |
Where it floated the last time |
Back in the layout it goes decides where it goes when it is arranged again: to its old place, with the same
neighbors and split as before (tile_position = "previous", the default), or beside the focused window like a new
window ("focused").
[tiling]float_position = "center"tile_position = "previous"Windows that float on their own
Section titled “Windows that float on their own”Some windows float without a rule:
- dialogs, sheets and panels;
- windows whose size an app does not let be set, such as fixed-size dialogs;
- a window that does not fit or keeps changing its size. It joins again when there is room. Settings › Layout & Tiling lists these with the reason under Floated Automatically.
Finding floating windows
Section titled “Finding floating windows”The control bar’s Floating section lists the space’s floating windows and marks those that other windows cover. A
click brings one forward. Bring Floating Windows to Front in the bar, or space --raise-floating, raises them
all. See Control bar.
Window rules
Section titled “Window rules”A rule says what to do with the windows of an app. Edit rules on Settings › Apps: Add Rule, choose the app and what should happen. Rule for an app in a window’s menu opens a new rule for that app, filled in as the window is now; nothing is written until you save it.
Rules act when a window appears. With Also at launch (apply_rules_at_launch, on by default), they also act on
the windows that are open when TilingBud starts. Apply Rules to Open Windows Now on the Apps page, or Apply
Window Rules Now in the menu, applies them to every open window.
What Rules Did on the Apps page shows what the rules did, newest first.
What a rule can do
Section titled “What a rule can do”| Settings | Key | What it does |
|---|---|---|
| Outside the layout (floating) | float = true |
The app’s windows never tile |
| Always in the layout | float = false |
Arranged even where TilingBud would let them float |
| Open on space | space = 3 or space = "Comm" |
Windows move to that space when they appear |
| Assign to all spaces | all_spaces = true |
The app’s windows are on every space; they always float |
| Dock to an edge | dock = "right" |
The window floats at that edge; tiled windows leave room for it |
| No border | border = false |
The app’s windows get no border |
slot = "mail.1" |
The window goes into a place of a saved layout |
A space can be named by its number on its display or by its name. A name finds the space on any display, however the
numbers shift. Add display to send windows to a space on another display.
[[rule]]app = "Slack"space = "Comm"
[[rule]]app = "Calculator"float = trueborder = false
[[rule]]app = "iPhone Mirroring"dock = "right"Matching windows
Section titled “Matching windows”A rule needs at least one of these:
app: the app’s name, or the path of a program ("~/Applications/Foo.app").bundle: the bundle identifier, such ascom.apple.finder.title: a regular expression on the window title.roleandsubrole: the Accessibility role, such assubrole = "AXDialog". They only decide floating and docking.
except_apps and except_title leave windows out. main = true matches only an app’s main window and main = false
its other windows; use it for apps with one main window.
[[rule]]subrole = "AXDialog"except_apps = ["Xcode"]float = trueOn Settings › Apps a rule takes the same fields: Window title matches, Except title, Except apps, Role and Subrole.
Docked windows
Section titled “Docked windows”A docked window floats at its edge and is placed there when it opens. On a bsp or main space the tiled windows leave a strip for it, so they never cover it. Dragged away from its edge, it stays where you drop it until it closes.
Under Docked Windows on Settings › Layout & Tiling, Reserved area keeps the strip only while a docked window is
on the space (dock_zone = "auto"), or always ("always"), so the tiled windows do not move when it opens or
closes. Area width sets the strip for the second choice (dock_size, 340 points).
Always on top
Section titled “Always on top”By command
Section titled “By command”tilingbud rules --add app=Calculator float=true writes a rule and applies the rules. tilingbud query --rules lists
them and rules --remove removes one. See the command line and the
rule keys.