Coming from niri
niri, on your Mac
If you love niri on Linux, you already know how TileMyMac works. Windows sit side by side on a row that runs past the edges of your screen, and opening a new one never squeezes the others.
niri is a scrollable-tiling Wayland compositor: windows are columns on an infinite strip, and you scroll along it. macOS has nothing like it built in. TileMyMac brings the same idea to your Mac, with a settings window instead of config.kdl.
What carries over
| In niri | In TileMyMac |
|---|---|
| Columns on an infinite strip | A row of windows that slides past the edges of your screen |
| Opening a window never resizes the others | The same: a new window takes the next spot, and the rest keep their width |
| Preset column widths | ⌃⌥R steps through ½ → ⅔ → full width, ⌃⌥⇧R goes back |
| Windows stacked in a column, or shown as tabs | ⌃⌥[ and ⌃⌥] stack a window into a neighbouring column; ⌃⌥⇧T shows a stack as tabs |
| Floating windows | ⌃⌥T lets a window float above the row, or puts it back |
| Workspaces stacked vertically | Workspaces, each its own row of windows: ⌃⌥1 to ⌃⌥4, up to 9 |
| Each monitor has its own strip | Each display gets its own row |
| Touchpad gestures | Swipe with three or four fingers to slide the row |
| config.kdl, with live reload | A settings window. Changes apply straight away |
See the full list on the shortcuts page.
What's different on a Mac
It works with macOS, not instead of it
TileMyMac isn't a compositor. macOS still draws every window, and TileMyMac moves and resizes them, using the Accessibility permission macOS asks you for once. Nothing about your Mac's security needs to be switched off.
One setting to check
Turn on Displays have separate Spaces in System Settings › Desktop & Dock. The guided setup on first launch walks you through it, along with the trackpad settings.
Mac-style shortcuts
Shortcuts start with Control + Option instead of Super, and H J K L work in place of the arrow keys. You can switch the starting keys to Option, or Command + Option, in Settings.
Set up by clicking
There's no config file. Widths, gaps, workspaces, gestures and shortcuts are all in a settings window, and changes apply straight away.
Built on a niri-inspired engine
TileMyMac runs on Paneru, an open-source (MIT) window engine for macOS. Paneru's own README says its sliding strip is directly inspired by niri and PaperWM.spoon. TileMyMac adds a settings window, a guided setup, a menu bar app and email support on top. If you'd rather configure everything in a TOML or Lua file yourself, Paneru on its own is free.
Try the row on our home page: see how TileMyMac works.
Get TileMyMacSources, checked October 15, 2026: niri on GitHub, Paneru on GitHub. Something out of date? Tell us and we'll fix it.