Migration

Niri keybindings on Mac: map the window actions

For the closest Niri-style keyboard movement on a Mac, map Mod+H/L to Control–Option–H/L to focus left or right, and Mod+Ctrl+H/L to Control–Option–Shift–H/L to move a window. Niri itself is a Wayland compositor, while SlidePane provides a scrolling strip on macOS. The map below uses Niri's default config and SlidePane's shipped shortcuts, checked on 2026-11-12. We make SlidePane.

Key facts

  • Niri uses configurable KDL keybindings; Mod depends on how niri runs.
  • SlidePane defaults to Control–Option shortcuts, which you can review in Settings → Shortcuts.
  • Similar key names can have different behavior. Niri columns and SlidePane's horizontal strip are different layouts.
  • Niri actions for spawning apps, monitor focus and workspace movement have no direct matching shortcut in SlidePane.

Start with what the keys do

The niri project describes itself as a scrollable-tiling Wayland compositor. Its default config binds Mod+H or Mod+Left to focus the previous column, Mod+L or Mod+Right to focus the next, and Mod+J/K or Down/Up to move focus between windows in a column. In the default config, Mod means Super in a TTY session and Alt when niri runs inside a nested window. On a Mac, a key labelled Command or Option does not automatically reproduce Mod.

The following rows map intent, not the niri key itself. The SlidePane shortcut shown is the shipped default from its shortcut catalog. Change it in Settings → Shortcuts if it conflicts with another app.

Niri default actionClosest SlidePane actionWhat changes
Mod+H/Left, Mod+L/Right: focus a neighboring columnControl–Option–H/L: Focus left/rightMove focus along the strip. Scroll mode keeps windows in sequence at individual widths.
Mod+K/Up, Mod+J/Down: focus a window within a columnControl–Option–K/J: Focus up/downUse when windows share a stack or a fixed layout slot. It differs from some Niri column operations.
Mod+Ctrl+H/Left, Mod+Ctrl+L/Right: move a columnControl–Option–Shift–H/L: Move window left/rightReorders one managed window along the strip; niri can move a whole column.
Mod+Ctrl+K/Up, Mod+Ctrl+J/Down: move a window verticallyControl–Option–Shift–K/J: Move window up/downChanges the window's position in a stack or fixed layout. Niri can move a full column.
Mod+Shift+arrows: move a window to another displayControl–Option–N: Next displaySends the focused window to the next display; it does not select a specific display.
Mod+R: cycle column widthControl–Option–R: Cycle widthCycles SlidePane's width presets.
Mod+Minus/Equal: adjust column widthControl–Option–Minus/Equal: Narrower/WiderChanges the focused window's width.
Mod+V: toggle floatingControl–Option–Shift–F: Toggle FloatingChanges the focused window between floating and managed states.
Mod+1–9: switch workspaceControl–Option–Command–1–9: Switch to workspace 1–9Adding Shift moves the focused window to that workspace.
Mod+Home/End: focus first/last columnControl–Option–Command–Left/Right: Focus first/lastFocus the first or last managed window in the strip.
Mod+Ctrl+Home/End: move column to first/lastControl–Option–Command–Shift–Left/Right: Move first/lastReorder the focused window to an end of the strip.
Mod+Comma/Period/brackets: column and stack navigationControl–Option–S/U: Stack/UnstackPartial match: SlidePane combines a window with its neighbor or separates a stack; it has no direct matching bind for each Niri key.
Mod+F: maximize column; Mod+Ctrl+F: expand columnControl–Option–F: Full width, and backMakes the focused window full width, then returns it to its prior width. Niri's maximize and expand actions have different rules.
Mod+C: center columnControl–Option–C: Center the windowCenters the focused window.
Mod+Q: close windowNo SlidePane window-closing shortcutClose the window with its app or macOS controls. Closing remains with the app or macOS.

Niri also has binds for focusing and moving columns between workspaces or monitors, toggling floating windows, changing tabbed-column display, and toggling overview. Several of those actions have no one-key counterpart. SlidePane has workspaces 1 to 9 and window movement to them, with Control–Option–Command–1 to 9 and Shift added to move a window. The app's workspaces are separate from macOS Spaces. Read the Shortcuts pane for the precise action labels.

Several additional defaults are useful to know. Control–Option–R cycles width presets; Control–Option–Minus and Control–Option–Equal make a window narrower or wider. Control–Option–Shift–F toggles floating. Control–Option–Command–1 through 9 switches workspaces, and adding Shift moves the focused window to that workspace. These are SlidePane workspace actions; macOS Spaces remain controlled by macOS.

The comma, period, and bracket actions are partial matches for Niri's stack behavior. Control–Option–S stacks a window with its neighbor, and Control–Option–U unstacks it; those actions differ from Niri's stack commands. Control–Option–N sends the focused window to the next display. The catalog has no full monitor-focus or monitor-workspace mapping.

Learn one movement at a time

Try the focus shortcuts first with two ordinary windows. Control–Option–H and L move focus left or right. Then test Control–Option–Shift–H or L to move a window. The Shift modifier is the difference between selecting a neighbor and changing the order. If the result surprises you, use Undo with Control–Option–Z.

Next, add a window you want grouped with another. The stack action, Control–Option–S, combines a window with its neighbor. Unstack uses Control–Option–U; tabs can be toggled with Control–Option–T. Niri's Mod+W toggles tabbed display for a whole column, so the resemblance is partial. Check the stacks and tabs guide to see how the app's grouping works.

Know what cannot be mapped

A keybinding map should also show where the analogy ends. Niri can launch a terminal or app launcher through configured commands. SlidePane leaves those launchers to their own apps. Niri's monitor and workspace actions reflect Wayland's output and workspace model; macOS displays and Spaces have their own behavior.

To inspect a whole arrangement, use Strip Overview from the app's shortcut list. For a fixed layout, choose Grid or Columns in Settings → Layout. Those modes use one to four slots; extra windows can join tabs in the last slot. These are layout choices with their own behavior, rather than a port of Niri's configuration.

Sources

The Niri for Mac workflow article covers the broader transition. See the shortcuts guide for rebinding and Profiles and Undo for saving or reversing a layout.

Cite or share this page

Dapols. "Niri keybindings on Mac: map the window actions." SlidePane, November 18, 2026. https://slidepane.com/en/blog/niri-keybindings-mac

The link is stable. The citation uses the page's “Last updated” date.