[!WARNING]
Fake accounts are impersonating OmniWM and its author on other platforms. OmniWM communicates only through its official GitHub repository, github.com/OmniNull/OmniWM. Fake accounts found so far:
x.com/BarutSRBx.com/OmniWM
OmniWM is free and has no hidden paywalls, as I promised from the start and I would rather eat 💩 than go back on that promise. The only official way to sponsor the project is GitHub Sponsors, because paying contributors back honestly needs a ledger.
— BarutSRB
OmniWM
OmniWM is a free, open-source, Developer ID-signed and Apple-notarized tiling window manager for Apple Silicon Macs running macOS 26 or later. It combines Niri-style orientation-aware scrolling containers and Hyprland-style Dwindle BSP layouts, selectable per workspace, with multi-monitor routing and optional local CLI/IPC automation.
Website · Documentation · Install · Compatibility · Fluxer
Demo Video
Contributors
🤝 Company Sponsors
🛠️ Maintainers
🏢 By Employer
🎓 By Education
✨ All Contributors
Highlights
- Optional window switcher with previews and separate Command-Tab / Option-Tab workspace scopes
- Ghostty-powered quake/sticky terminal
- Optional app theming that colors Ghostty, kitty, herdr, Neovim and your own templates from the palette in light and dark
- Native macOS window-tab support
- Local IPC and
omniwmctl automation
- Scratchpads and sticky windows for any app
- Overview
- Unified command palette for windows, app menus, clipboard history, OmniWM commands, applications, and files
- Menu Anywhere
- Niri-style tabbed containers and Dwindle tile groups
- Niri-style scrolling and Hyprland-style Dwindle BSP layouts
- Status-bar icon concealment (similar to Ice)
- Keep Awake (similar to Caffeine)
- Interactive workspace and app-icon bar
Requirements
- macOS 26+ (Tahoe) on Apple Silicon, SIP stays on
- Accessibility and Input Monitoring
Displays have separate Spaces turned on in System Settings > Desktop & Dock > Mission Control- Optional: Screen Recording (Overview thumbnails, drag previews) and Full Disk Access (Hidden Bar, Notifications widget)
Details and known limitations: Compatibility, Requirements & Limitations.
Installation
brew install --cask omniwm
This installs OmniWM.app and puts omniwmctl on your PATH. OmniWM is also in nixpkgs with a Home Manager programs.omniwm module, and on GitHub Releases. Nix setup, canary builds, upgrading, and moving off the retired BarutSRB/tap are in the install guide.
OmniWM checks for new releases once a day and never installs anything on its own. Turn it off in Settings > General > Updates.
Quick Start
- Turn on
Displays have separate Spaces and log out and back in if it was off
- Launch OmniWM, grant Accessibility and Input Monitoring (Screen Recording is optional), then click Start OmniWM
- Windows tile into Niri scrolling containers; switch a workspace to Dwindle BSP with
Toggle Workspace Layout
Option + 1-9 switches workspaces and Option + Shift + 1-9 moves the focused window; the rest is in Keyboard Shortcuts
Settings live in ~/.config/omniwm/settings.toml and reload when you save it. More in the full quick start.
Documentation
Everything lives at omniwm.app and follows current main.
Community
Questions, setup help and config sharing happen on the OmniWM Fluxer and OmniWM Discord. Integrations (omacosy, OmniWM Computer Use, OmniCast) and related forks (Nehir, choru-k/OmniWM) are listed on Community & Support.
Reporting Bugs
Use the GitHub issue form and include your OmniWM and macOS versions.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
