First five minutes
TilingBud is installed, it has Accessibility, and the setup assistant is done or skipped. These five steps show how it works. The keys are the default ones; the recommended set from the setup assistant adds more, listed on the Shortcuts page.
1. Open a few windows
Section titled “1. Open a few windows”Open three or four windows: a browser, Notes, Terminal. Each new window takes a place in the layout of the space and
the others make room. With the default layout, bsp, a new window splits the area of the focused window: side by side
while that area is wider than high, else on top of each other. Close a window and the others fill its place.
The focused window has a colored border. The menu bar shows a pill for each space, with an icon for every window on it. Rest the pointer on a pill to see its windows, and click a pill to switch to that space.
Go further: Menu bar, Borders, Layouts.
2. Switch the layout on the control bar
Section titled “2. Switch the layout on the control bar”The control bar sits at the left edge of the screen. It shows the space, its layout, its windows and its floating windows. Click the layout symbol: a chooser shows every layout with a preview of your windows.
- Split (
bsp): each new window splits the focused one. - Main and secondary (
main): one main area, the other windows beside it. - Stacked: all windows on one frame, the focused one in front.
- Scroll: columns in a row that can be wider than the screen.
- Off: TilingBud leaves the windows of this space alone.
The choice holds for this space only and stays after a restart. Save for This Space writes it into the configuration file.
Go further: Control bar, Layouts, Saved layouts.
3. Float a window with ⌥T
Section titled “3. Float a window with ⌥T”Focus a window and press ⌥ T. The window leaves the layout and floats in the middle of the screen; the other windows close the gap. Press ⌥ T again and it goes back to its old place.
The floating section of the control bar lists the floating windows. A window that should always float, for example Calculator, gets a rule in Settings › Apps.
Go further: Floating windows and rules.
4. Switch spaces with ⌃1 to ⌃0
Section titled “4. Switch spaces with ⌃1 to ⌃0”Press ⌃ 2 to show space 2, and ⌃ 1 to come back. ⌃ with a number from 1 to 0 shows the desktops 1 to 10. If you have only one space, add one in Settings › Spaces or in Mission Control.
Go further: Spaces and displays.
5. Move a window to another space
Section titled “5. Move a window to another space”Focus a window and press ⌃ ⌥ 2. The window moves to space 2 and you stay where you are; its icon moves to the second pill. With ⌃ ⌥ ⇧ 2 the window moves and you go along to space 2.
Go further: Keyboard and mouse, Shortcuts.
- Every shortcut can be changed in Settings › Shortcuts, which also warns when a key is in use.
- Scripts and bars can react to events: Signals.
- If something does not move, check Permissions and Troubleshooting.