An automatic tiling window manager for Macotron.
Windows on a display are arranged as tiles that fill the screen and never overlap. Open a window and the others make room. Close one and the rest grow back. The focus moves from tile to tile with the keyboard, so the pointer stays where it is.
- Master and stack puts one window down the left and stacks the rest on the right.
- Columns gives every window an equal column.
- Centered master puts the master in the middle and a stack down each side. This is for a wide screen, where one window stretched over the full width is unreadable.
- Grid gives every window a cell of the same size.
- Apps you never want tiled are listed in Float rules, and any single window can be pulled out of the layout with one key.
Macotron with plugin API 1.3 or newer, for the minimized flag on a window. Tiles refuses to load on an older host rather than tile around windows it cannot see properly.
- Open Macotron. Go to Settings → Plugins → Catalog → Community.
- Find Tiles. Press Add.
- Read the source in the review sheet. Press Add again.
Macotron scans the plugin before it runs.
Tiles needs the Accessibility permission, because moving another app's window is an accessibility operation. macOS asks the first time a window moves.
Every key is rebindable in Settings → Plugins.
| Key | What it does |
|---|---|
ctrl+opt+shift+H / J / K / L |
Move the focus left, down, up, or right |
ctrl+opt+cmd+H / J / K / L |
Swap the focused window with that neighbour |
ctrl+opt+shift+Return |
Send the focused window to the master area |
ctrl+opt+shift+Space |
Change the layout on this display |
ctrl+opt+shift+T |
Stop or start tiling this display |
ctrl+opt+shift+F |
Leave the focused window where it is, or put it back |
ctrl+opt+shift+= / - |
Grow or shrink the master area |
ctrl+opt+shift+] / [ |
Focus the next or previous display |
The focus keys pick the nearest window in that direction by the middle of its frame, not the next one in a list, so the focus goes where you are looking.
Every action above is also a command in the launcher, so a key you cannot remember is not a feature you have lost. Two commands have no key.
Tiles Diagnostics writes the whole tiling state to the log: the host API
version, whether windows carry a stable number, the tile order on each display,
and the reason every untiled window was skipped. Run it when a window will not
tile and read the log with make trace.
Tiles Self Check tests the layout maths and the window key.
The menu bar item shows the current layout and opens the same controls.
| Option | Default | What it does |
|---|---|---|
| Tile on launch | on | Start tiling as soon as the plugin loads |
| Layout | Master and stack | The layout a display starts with. Master and stack, Columns, Centered master, or Grid |
| Gap (px) | 8 | Space between a tile and the screen edge or its neighbour |
| Minimum window size (px) | 320 | Windows smaller than this on both sides are left alone |
| Float rules | see below | App names or bundle IDs that are never tiled, one per line |
| Main display only | off | Tile the main display and leave other screens alone |
| Flash the focused window | on | Outline a window briefly when a Tiles key moves the focus to it |
| Log every layout pass | off | Write a line for each window on every pass, to find a fault |
Macotron's own windows — the launch bar, the Settings window and any panel a plugin opens — are never tiled. That one is fixed in the plugin and is not a rule you can edit away.
Float rules start with the windows that tile badly: System Settings, Calculator, App Store, Activity Monitor, Archive Utility, Disk Utility, the Finder save dialog, and Installer. A rule matches an app name, a bundle ID, or any part of an app name.
macOS has no window manager API. Everything here goes through Accessibility, and these limits are real rather than bugs to be fixed later.
- Nothing reports a closed window. macOS posts a notification when a window opens, and none when one closes. Tiles polls every two seconds to notice, so a closed window's space is reclaimed a moment later rather than instantly.
- Minimizing is noticed on the next pass. A minimized window keeps no place on screen, so Tiles drops it from the layout. It is spotted by the same two second poll as a closed window, not the instant it goes to the Dock.
- Moves are asynchronous, and some apps argue. An app may clamp a resize to its own minimum size, refuse it, or animate into place. Terminal emulators that resize in whole character cells will not land exactly on the grid.
- Window identity needs a recent host. Windows are tracked by the window server's own number, which survives a retitle and a raise. A host older than plugin API 1.5 reports no number, and Tiles falls back to the app name and the title. On that older host a terminal that retitles itself loses its place in the layout, and two windows of one app with the same title can be confused.
- Fullscreen windows are outside this. A window in native fullscreen has its own space and is not tiled.
- Spaces are barely visible to any app. Tiling is redone when you change space, but macOS does not say which windows live on which space, so windows on another space are laid out as though they were here.
- A window you drag is put back at the next layout change, not the moment you let go. Use the float key to keep one window where you put it.
MIT. See LICENSE.