Spacetile is a tiling window manager for macOS: it arranges your windows side by side so they fill the screen without overlapping, and lets you move them with the keyboard or the mouse. It tiles the Spaces you already have as windows open, brings setups back from a Focus or a display, and works alongside full screen, Split View and macOS’s own tiling.
To see how that compares with yabai, AeroSpace, Rectangle, ShiftPlus and others, see Spacetile compared.
Built on macOS
Your Spaces, tiled
Spacetile has no workspaces of its own. The Desktops it tiles are the ones in Mission Control, numbered as Mission Control numbers them, on every display.
- Nothing is hidden off screen. Every window stays on its Desktop, where Mission Control, App Exposé and ⌘Tab expect it.
- macOS keeps working. Swiping between Desktops, the Spaces bar and dragging windows between Desktops in Mission Control still work, and windows you drag there join the right layout.
- Instant switching. ⌥1…⌥0 switch Desktops with no slide animation (see Switching).
- Sending windows. ⌥⇧1…⌥⇧0 move the focused window to another Desktop, laid out before you arrive.
- Both display modes. “Displays have separate Spaces” can be on or off; Spacetile follows macOS in each.
Full screen and Split View
Full-screen apps keep the Space macOS gives them, and Spacetile works around it:
- Counted in place. ⌥N counts full-screen Spaces where Mission Control shows them, so switching to one works like switching to a Desktop.
- Back to the tile. Leaving full screen puts the window back beside the same neighbours.
- Split View by command.
fullscreen pairputs the focused window and its neighbour into Split View, each on the side it’s on now. - Rules. Rules → Open full screen makes an app’s new windows go full screen.
- Profiles. Profiles record full-screen apps and Split View pairs and bring them back.
- Shown. The mini-map and the menu-bar item show full-screen Spaces among the Desktops.
See Full-screen apps.
macOS tiling joins in
The green button’s Move & Resize and Fill & Arrange, Window → Move & Resize and the fn⌃ arrow keys all work. Spacetile treats what macOS did to a tiled window as its own command and re-tiles the other windows around it, instead of snapping the window back. See macOS tiling.
Tiling
- Splitting. A new window splits the focused tile along its longer side. Rows and columns (as in i3 and AeroSpace) or a main window with a stack beside it are a setting away.
- Three layouts per Desktop. Tile, Stack (every window fills the Desktop; cycle with ⌥n / ⌥p) or Float. Set each Desktop’s layout in Settings or a profile, or switch the current one with ⌥d (Tile) and ⌥s (Stack).
- Floating windows. ⌥f floats or tiles a window; apps and window titles can float by rule.
- Placing. Halves, thirds, two-thirds, quarters, sixths, the middle third and any share of an edge, each re-tiling the other windows into what’s left. Pressing an edge again cycles ½ → ⅔ → ⅓.
- Holes. When a placement has more tiles than windows, empty tiles keep its shape, and the next window fills them.
- Restore. ⌥⌃r undoes the last run of place, grow and shrink.
- Rearranging. Swap, join, flip a split, zoom, balance, mirror and rotate, each with a shortcut.
- Preselect. Choose which side of the focused window the next one opens on; a hint shows where.
- Stack on overflow. Spacetile learns each window’s minimum size. A window that won’t fit goes to another tile with room, or joins a stack, and stacks split back out when there’s room. A drop that can’t fit names the window that needs room.
- Gaps and padding that suit the display, or your own.
toggle spacingturns them off for edge-to-edge tiles and back on. - Animation, if you want it. Turn on Animate windows in Settings → General and windows slide into their tiles instead of jumping there. It’s off by default because Accessibility moves a window one step at a time, so a re-tile takes a moment longer. Windows always jump while Reduce Motion is on.
See Spaces and layouts and Commands.
Focused window
Two options in Settings → General, both off until you turn them on:
- Active window border. An outline round the focused window, in your accent colour or one you pick, at the opacity you set. It follows the window as it moves, resizes or is dragged.
- Dim other windows. A shade over everything behind the focused window on its display, so the window you’re using stands out. The Dimming slider sets how dark it is. Clicks go through it.
Neither changes another app’s windows. Spacetile draws its own click-through windows just above and just below the focused one, so it needs no system changes. Windows in front of the focused one, like a floating window above it, stay undimmed. Bind toggle border and toggle dim in Settings → Keys to switch them from the keyboard.
Mouse
- Focus follows mouse, without raising, and mouse follows focus. Either can be turned off.
- Drag to retile. Drag a window by its title bar onto another tile to swap with it, insert beside it, or fill a hole. A highlight shows which.
- Drag to resize. Drag the edge between two tiles, or the gap between them; both windows follow.
- fn shortcuts. fn + drag moves a window from anywhere in it; fn + drag to a screen edge sends it to the next or previous Desktop; fn + right-drag resizes from the nearest corner.
See Mouse.
Profiles
A profile records which apps sit on which Desktop and how each Desktop tiles, then applies that again.
- Capture or design. Save the current layout from the menu bar, or build one in the profile designer from templates.
- Apply from the menu bar, by shortcut, from the command line, when a Focus turns on or off, or, if you turn it on, when the displays it was made for connect.
- Fills in what’s missing. Apps that aren’t running are launched, and their tiles wait for their windows.
- Opens what you work on. An app the profile launches can open links, files, folders or a Terminal command too.
- Tidies the rest. Apps a profile doesn’t mention can be left, hidden or quit.
- Moves between Macs and displays. Each recorded display is matched to a connected one by signature, name or role.
- Plain JSON, one file per profile, ready for your dotfiles.
See Profiles.
Displays
- Each display tiles its own Desktops, whether Spaces are separate per display or span them.
- Moving between displays. Commands focus the next display, or send a window to the Desktop showing there; dragging a tiled window onto another display drops it into that display’s tiling.
- Display changes. After sleep, or when displays come and go, Spacetile waits for macOS to settle and lays everything out again, or applies a profile you’ve set to apply for those displays.
Menu bar
- Status at a glance. The menu-bar item shows the Desktop’s number, label, layout and stacked windows, or every display’s Desktop at once.
- Mini-map. Clicking the item shows every Desktop on every display, with its windows as app icons, or as live previews if you turn on Show window previews. Click to switch, or drag a window onto another Desktop to send it.
- Spaces bar. The mini-map opens into a Spaces bar across the top of the screen.
- Profiles and pause. Profiles apply in one click from the mini-map, and a switch pauses all tiling.
Keys and scripting
- Every action has a shortcut and a text command: the same commands in Settings,
config.json, the command line and Raycast. - Grouped shortcuts. Default shortcuts use one set of modifier keys per family. Move a whole family at once in Settings → Keys.
- Start from what you know. Shortcuts can start from Rectangle, Spectacle, AeroSpace, Amethyst, BetterStage or ShiftPlus.
- Other key binders. Raycast, skhd and Karabiner-Elements can drive Spacetile instead, with Spacetile’s own shortcuts turned off.
See Commands.
Settings and rules
- A Settings window for everything, with undo, and a plain
~/.config/spacetile/config.jsonthat applies the moment you save it. A file with a mistake in it doesn’t replace the settings that are running. - Rules float apps or window titles, send an app’s windows to a Desktop, or open them full screen.
- Labels and layouts for each Desktop, shown in the menu bar.
- Setup checks. Spacetile checks the macOS settings it relies on and links to each one.
See Configuration.
Permissions and privacy
Spacetile needs Accessibility, to move and focus other apps’ windows. Screen Recording is asked for only if you turn on window previews, and previews are kept in memory, never saved. See Privacy.
What it doesn’t do
- Create, delete or reorder Spaces. macOS doesn’t let apps do that, so add Desktops in Mission Control.
- Change another app’s window opacity or layer, or show a window on every Space. macOS doesn’t allow these either. Dimming works without them; see Focused window.
- Tile full-screen Spaces. macOS lays those out itself.
- Ship in the Mac App Store. Its private window-server calls rule that out.
How it works without SIP has the technical detail.