macOS Spaces are the separate desktops you see along the top of Mission Control. Each one is called Desktop 1, Desktop 2 and so on, and full-screen apps get a Space of their own. Spacetile tiles the windows on each Desktop, and lets you switch between Spaces and move windows to them from the keyboard.
This page explains how Spaces, layouts and tiling behave. For the shortcuts themselves, see Commands.
Native Spaces
Spacetile uses the Spaces you create in Mission Control. It has no workspaces of its own, and it can’t create, delete or reorder Spaces, because macOS doesn’t let apps do that.
To add a Space, open Mission Control (⌃↑) and click + at the top right. If you have only one, Settings → Permissions suggests adding a few.
Spaces are numbered as Mission Control shows them: each display has its own Desktop 1, 2, 3…. Settings shows as many Desktops as your busiest display has, in the Keys, Rules and Spaces panes and in the profile designer. Settings for Desktops you haven’t created yet stay in config.json, ready for when you add them.
Switching
⌥1…⌥0 switch Spaces instantly, with no slide animation. Spacetile does this with a synthetic trackpad swipe. On macOS 27 that needs the trackpad’s swipe-between-Spaces gesture turned on: System Settings → Trackpad → More Gestures → Swipe between full-screen applications. Settings → Permissions checks it for you.
If an instant switch doesn’t land, Spacetile steps there with ⌃← and ⌃→ instead, with the usual animation. Both ways count full-screen apps’ Spaces as well as Desktops, so switching works from a full-screen app too.
Sending
⌥⇧1…⌥⇧0, ⌥⇧. / ⌥⇧, and fn + drag to a screen edge move the focused window to another Space. This takes about 15 ms and lays the window out on the target Space before you get there.
- Follow after sending (Settings → General, on by default) decides whether you go with the window.
- Next and previous skip full-screen Spaces and wrap round from the last Desktop to the first.
- ⌥⇧ and a number can’t send a window to a full-screen app’s Space.
- Dragging a window between Spaces in the menu-bar mini-map never follows.
Windows you drag between Spaces in Mission Control join the right layout the next time the Space changes.
Several displays
Spacetile tiles the Space showing on every display, each within its own display. Commands follow macOS:
- ⌥1…⌥0, next, previous and last switch Spaces on the active display: the one with the menu bar, where the pointer is.
- Sending a window to Space N uses Space N on the window’s own display.
display next/display prevfocus the next or previous display, andsend display next/send display prevmove the focused window to the Space showing there. Displays are ordered left to right, then top to bottom, as arranged in System Settings, and wrap round. A display showing a full-screen app can’t take a window.- Dragging a tiled window onto another display drops it into that display’s tiling, with the same swap and insert highlights, or “Move to display” when that Space is empty. Swapping with a window there sends that window back into the dragged window’s old place.
- Space labels and layout modes in Settings apply to Desktop N on every display. App → Space rules send windows to Desktop N on the active display.
- The menu-bar item describes the active display, and switches as soon as focus moves to another one. macOS shows the same item on every display’s menu bar; choose the Every display index style (Settings → Menu Bar) to see each display’s Space at once.
“Displays have separate Spaces” (System Settings → Desktop & Dock) can be on or off, and Spacetile follows macOS either way:
- On (the macOS default): each display has its own Desktops, as above.
- Off: one set of Desktops spans every display, and switching changes all displays together. Each display still tiles its own windows on the current Desktop. In the mini-map, each Desktop is one card with every display drawn inside it; drop a window onto a display’s part of the card to move it to that Desktop on that display. The setting takes effect after you log out.
When displays are connected or removed, or after the Mac wakes, Spacetile waits about 1.5 seconds for macOS to settle, then lays every display out again. If a profile is set to Apply automatically for exactly the displays now connected, it applies instead (see Profiles).
Layout modes
Each Space has one of three layout modes:
| Mode | What happens | Shortcut |
|---|---|---|
| Tile | Windows sit side by side, filling the Space without overlapping | ⌥d |
| Stack | Windows overlap, each filling the Space; ⌥n / ⌥p and the focus keys cycle through them | ⌥s |
| Float | Spacetile leaves the windows where you put them | none (layout float) |
The shortcuts change the Space you’re on. Settings → Spaces sets each Desktop’s starting mode, and a profile can set it too. A change in Settings applies to Spaces laid out from then on.
Floating windows (⌥f, or apps in the “Always float” rule) sit outside the tiling on any Space, on top of the tiled windows.
Algorithms
Settings → General → Layout algorithms chooses how Tile and Stack Spaces arrange windows. The choice applies to every Space at once; in config.json it’s tiling and stacking.
| Tiling | A new window… | Closing a window… |
|---|---|---|
| BSP (default) | Splits the focused tile in two, along its longer side. The existing window keeps the default share (half, unless you change it) | Gives its space to the tile it was split from |
| i3 (rows and columns) | As in i3, Sway and AeroSpace: joins the focused window’s row or column, just after it, taking an even share. The others give up space in proportion to their size | Shares its space out across its row or column. ⌥e turns the whole row into a column, or back |
| Master and stack | Joins the end of the stack beside the main window, which keeps its current share. Swap a window into the main tile, or pop it out (⌥⇧o), to make it the main window. Mirror or rotate to move the stack to the left or below | Closes up the stack. Closing the main window promotes the first window of the stack |
BSP stands for binary space partition: each new window halves a tile. Every algorithm uses the same underlying layout, so preselect, join, swap, dragging, resizing, place, profiles and stack on overflow work with each. Preselect and dragging split a tile exactly where you say, whichever algorithm is on.
Changing the algorithm leaves each Space as it is, except master and stack, which rearranges every Space straight away. An applied profile keeps its saved arrangement either way.
| Stacking | Layout |
|---|---|
| Fill (default) | Every window fills the Space |
| Accordion | The front window leaves a strip of up to 30 pt at each side where the windows before and after it peek out, as in AeroSpace |
Stack on overflow
Some apps refuse to shrink below a minimum size. Spacetile reads each window’s size back after placing it, and remembers the smallest size the window accepted. Then:
- A new window that wouldn’t fit beside the focused window tries the other split direction, then the other tiles, largest first. Only when no tile has room does it join the focused window’s tile as a stack. (This applies to BSP tiling.)
- A tile that turns out too small merges into its neighbour as a stack.
- Stacks split back out whenever there’s room again, such as after a window closes or a display gets bigger.
- A window may come up to one gap short of its minimum. It takes that part of the gap beside it, so nothing overlaps.
- A drop that can’t split (dragging a window onto a tile’s edge) stacks instead, and a red note over the tile names the window that needs more room, such as “No room to split: Google Chrome needs to be at least 469 pt tall”.
⌥n / ⌥p cycle through a stack. The menu-bar item shows how many windows are stacked out of sight, such as “+2”.
Holes
Holes are empty tiles that keep a placement’s shape when there aren’t enough windows to fill it. For example, placing the only window on the left half leaves a hole on the right.
- Holes show the desktop. Focus, swap and join skip them.
- New windows fill them. The next window opened on, sent to or moved onto that Space fills the first hole, unless you’ve preselected a spot. Holes a profile keeps for a particular app wait for that app’s windows.
- Dropping fills them. Dragging a window onto a hole fills it.
- They go away when a window leaves that Space’s layout (it closes, moves to another Space, is minimized or its app is hidden), when you balance (⌥b), or when you place a window afresh.
Restore
restore (⌥⌃r) puts back the layout from before a run of place, grow and shrink commands. Any other command starts a new run; dragging, resizing with the mouse and windows opening or closing don’t. Windows closed since are left out, and windows opened since are added as usual.
Full-screen apps
A window you make full screen (its green button, ⌃⌘F or ⌥⇧f) gets a Space of its own, which macOS adds after the last Desktop. Two windows in Split View share one. Spacetile doesn’t tile these Spaces and can’t move them; drag one in Mission Control to put it somewhere else.
Spaces are numbered by their place in Mission Control, full-screen ones included. So ⌥2 opens a full-screen app sitting second, and ⌥⇧2 refuses to send a window there. Dragging a full-screen app in front of a Desktop shifts that Desktop’s number by one. Labels, layouts, app rules and profiles stay with the Desktop: a Desktop labelled “Comms” keeps its label and its Slack rule when it moves from 2 to 3.
- Leaving full screen puts the window back in its tile, beside the same neighbours, as long as one of them is still there.
- The mini-map and Spaces bar show them where Mission Control does: a narrower card with the window (or both Split View windows, at their real widths), its number and the app’s name underneath. Click one to switch to it. You can’t drop windows onto them.
- The menu-bar item keeps the number and shows the full-screen mark ⤢ in place of the layout mode. The stepper style draws full-screen Spaces as small diamonds among the Desktops’ squares.
- ⌥. / ⌥, go to the Desktop either side of a full-screen app;
space fullscreen next|prevstep between full-screen apps. fullscreen pairputs the focused window and its neighbour into Split View, each on its current side. Spacetile chooses the app’s Window → Full-Screen Tile item, then clicks the neighbour in the picker macOS shows. If the neighbour doesn’t appear there, a blue note says which window to choose. macOS greys out the item for some windows, and those get a red note. Leaving full screen takes one window out at a time: the other stays full screen until you take it out too.- Rules → Open full screen makes an app’s new windows go full screen, after any Space rule has moved them.
- Profiles record full-screen apps and Split View pairs and make them full screen again when applied (see Profiles). Each lands after the last Desktop, so Desktop numbers don’t move.
macOS tiling
macOS has its own window tiling: the menu on a window’s green button (Move & Resize, Fill & Arrange), Window → Move & Resize, and the fn⌃ arrow keys. With Use macOS tiling with Spacetile on (Settings → General, on by default), Spacetile treats what macOS did to a tiled window as its own command. The window stays where macOS put it, and the other windows re-tile around it:
| macOS | Spacetile |
|---|---|
| Left, Right, Top or Bottom | place left … at ½ |
| A quarter | place top-left … |
| Fill | zoom |
| Arrange | Those windows tile in that shape; the Space’s other windows stack behind the last tile. Floating windows that macOS arranges join the tiling |
| Several windows tiled together into one half | Those windows keep that half, in their shape; the Space’s other windows tile in the other half |
| Return to Previous Size | restore (or zoom off, after Fill) |
Floating windows and Float-layout Spaces keep whatever size and position macOS gives them. Stack-layout Spaces put windows back into their stack.
With the setting off, Spacetile ignores what macOS does: the window stays where macOS put it until the Space is next laid out, and the other windows don’t move.
Dragging a window to a screen edge to tile it competes with Spacetile’s own drop zones, so Settings → Permissions suggests turning that off: System Settings → Desktop & Dock → Drag windows to screen edges to tile.
Menu-bar mini-map
Click Spacetile’s menu-bar item for a map of every Space and its windows. Windows are drawn as app icons, or as pictures of the windows if you turn on Show window previews in Settings → General (this needs the Screen Recording permission).
- Click a Space to switch to it.
- Click a window to go to it.
- Drag a window onto another Space to send it there. The card it would land on lights up with Move Here.
Each display has a row of its Desktops, as in Mission Control, wrapping onto more lines rather than hiding any. With more than one display, each row is titled with the display’s name, and the active display’s says “active”. The current Desktop has a white ring and a filled number. Other Desktops with no windows are dimmed. Floating windows have a dashed outline; hover one to see the shortcut that tiles it again.
Above the map, the Tiling switch turns tiling and every Spacetile shortcut except Pause off and on. Below it are your profiles, to apply in one click (the last applied is ticked), then Save Current Layout…, Edit Profiles…, Check for Updates…, Settings… and Quit Spacetile.
Spaces bar
The button at the top right of the mini-map’s Desktops opens the same map in a glass panel across the top of the screen, like Mission Control’s Spaces bar, with a row per display that scrolls sideways. It stays open while you click between Desktops and drag windows onto them, and keeps itself up to date. Click outside it or press Esc to close it. While Settings is open, Window → Spaces opens it too.