🪟 WindowTiler

One hotkey. Perfect grid. Every time.

A native macOS menu bar app that automatically tiles all visible windows of the previously-focused app into an even grid on screen.

Features

One-Hotkey Tiling — Press Cmd+Opt+T (customizable) to instantly tile all visible windows of the last-focused app into a perfect grid.
Smart Grid Calculation — Automatically computes optimal rows and columns via square root, or set custom grid dimensions.
Spatial-Aware Placement — Greedy nearest-neighbor algorithm ensures each window lands closest to its current position for minimal visual disruption.
Configurable Gap/Spacing — Fine-tune the pixel gap between tiled windows to match your aesthetic.
Launch at Login — Native launch-at-login support via SMAppService — no helper apps or hacks.
Menu Bar Only — Lives in the menu bar with no Dock icon, staying out of your way until you need it.
Accessibility API — Uses AXUIElement for reliable window manipulation with a clean permission prompt on first launch.
Smart Filtering — Automatically filters out dialogs, sheets, and minimized windows so only real windows get tiled.

Clone the repo

git clone https://github.com/markksantos/WindowTiler.git

Open in Xcode

cd WindowTiler
open WindowTiler.xcodeproj

Build & Run — Hit Cmd+R in Xcode. The app appears in your menu bar.
Grant Accessibility — On first launch, macOS will prompt for Accessibility permissions. Grant access in System Settings → Privacy & Security → Accessibility.
Tile — Focus any app with multiple windows, then press Cmd+Opt+T.

Component	Technology
Language	Swift 5.9+
UI Framework	SwiftUI
Window Management	Accessibility API (AXUIElement)
Login Item	SMAppService
Platform	macOS 14.0+
Build System	Xcode