Skip to content

Layout Modes

OmniWM offers two layout engines, and each workspace picks its own. Switch the active workspace’s layout with Toggle Workspace Layout (Option + Shift + L by default) or configure layouts per workspace in the GUI settings.

Niri (orientation-aware scrolling containers)

Section titled “Niri (orientation-aware scrolling containers)”

On monitors using horizontal orientation, windows form vertical columns that scroll left and right; in vertical orientation, they form horizontal rows that scroll up and down. Each container can hold multiple windows or be “tabbed” — multiple windows with one visible at a time.

A binary space partition layout that recursively divides screen space. Each new window splits the space in half, and a tile can group multiple windows as tabs. Best for traditional tiling with predictable layouts.

Windows can also float above the tiled layout in either engine:

  • Toggle Focused Window Floating (unassigned by default) floats or re-tiles the focused window.
  • App Rules can force matching windows to float — or to tile — instead of the automatic classification.
  • Raise All Floating Windows (Option + Shift + R) brings every floating window to the front, and Rescue Off-Screen Floating Windows (unassigned) recovers strays.
  • Scratchpads hold floating windows in ten toggleable slots.
  • Toggle Fullscreen (Option + Return) is OmniWM’s own fullscreen: the focused window fills the monitor while staying on its workspace, under OmniWM’s management. Press it again to drop back into the layout.
  • Toggle Native Fullscreen (unassigned by default) uses macOS’s built-in fullscreen, which moves the window into its own native fullscreen Space outside the tiled layout.

The full list of layout-related shortcuts — sizing, balancing, Dwindle splits and preselection, Niri spans and columns — lives in Keyboard Shortcuts.