Skip to content

About

Lay every window out as a tile automatically, and move the focus between tiles with the keyboard.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

17 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

Tiles for Macotron

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.

Requirements

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.

Install

  1. Open Macotron. Go to Settings → Plugins → Catalog → Community.
  2. Find Tiles. Press Add.
  3. 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.

Keys

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.

Options

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.

What macOS will not let this do

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.

Licence

MIT. See LICENSE.

About

Lay every window out as a tile automatically, and move the focus between tiles with the keyboard.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages