Skip to content
EN
Download

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.

⌥ 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).

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"

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.

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.

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.

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 = true
border = false
[[rule]]
app = "iPhone Mirroring"
dock = "right"

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 as com.apple.finder.
  • title: a regular expression on the window title.
  • role and subrole: the Accessibility role, such as subrole = "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 = true

On Settings › Apps a rule takes the same fields: Window title matches, Except title, Except apps, Role and Subrole.

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).

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.