[!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
- 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.
Contributing
Issues and pull requests are welcome. Start with CONTRIBUTING.md; the docs sources live in website/src/content/docs.
Building from Source
Follow the contributor quick start for Xcode requirements, automatic dependency setup with Lix and the repository's flake.nix, and a separate OmniWM Dev app with independent settings. The guide covers rebuilding, switching back to your normal app, and verifying a pull request.
Support
If you find OmniWM useful, consider supporting development through GitHub Sponsors.
License
OmniWM is licensed under the GNU General Public License v2.0-only. Copyright (C) 2026 OmniNull — https://github.com/OmniNull/OmniWM.
Every OmniWM source file carries an SPDX license header. App-bundled third-party notices stay in Resources/Licenses and ship in Contents/Resources/Licenses. They cover the vendored Luau and Lua runtimes (MIT), generic colour palettes adapted through Noctalia and Wayle (MIT), and Google's Material Color Utilities (Apache 2.0).
Optional styles keep their own notices in their folders. Vitreus retains its upstream MIT notice and the Space Grotesk font's OFL notice; Celestial retains the notices of Rubik, Google Sans Flex and Material Symbols Rounded. Each style README lists its credits and licences. Forks and redistributions must retain the applicable notices and the LICENSE file, and remain GPL-2.0-only with source available.
