What's New Since 0.6.7
OmniWM 0.6.8 moves Homebrew installs to the official cask, lets scripts and the CLI rename workspaces, makes switching between windows of the same app immediate again in Niri layouts, and fixes a crash on macOS 27 betas for users in comma-decimal regions.
Before You Upgrade
- Quit OmniWM before upgrading with Homebrew, then relaunch it. Homebrew replaces the app bundle underneath a running OmniWM, and a new
omniwmctltalking to an older running OmniWM getsinvalid_requestfor the newworkspace renameaction. - The project Homebrew tap is retired. OmniWM is in Homebrew's official cask repository, and 0.6.7 was the last release published to
BarutSRB/tap.
๐จ๐จ๐จ
If you installed with `brew tap BarutSRB/tap`, quit OmniWM and run, in this order:
1. `brew update`
2. `brew upgrade omniwm`
3. `brew untap BarutSRB/tap`.
๐จ๐จ๐จ
Keep that order: brew update fetches the retired tap's redirect and moves your install to the official cask, while untapping before it would offer to uninstall OmniWM. Full steps: Migrating from the project tap. New installs use brew install --cask omniwm.
- Settings and scripts are unaffected. This release needs no settings migration, and the IPC protocol stays at version 15.
New: Rename Workspaces from Scripts and the CLI
omniwmctl workspace rename <workspace> <display-name>sets a workspace label from the command line or over IPC. The target is a raw workspace ID or an unambiguous display name, the label persists tosettings.tomlexactly as if you had set it in Settings, an empty name clears it back to the raw ID, and renaming to the current label returnsno_change. #621- Rename from a launcher. A Raycast script command, or an OmniCast command with a picker, turns "type the new name, hit enter" into a rename straight from the root search, so a workspace can follow the project you are working on without a trip to Settings.
- Let events rename for you.
omniwmctl watch workspace-bar --reconnect --exec ./badge.shruns a script for every workspace-bar event, so a workspace can badge itself๐จ ALARMthe moment a window on it gets a title containing a keyword and drop the badge when that window goes away. The events guide ships the fullbadge.sh; it renames only when the computed label differs, and OmniWM publishesworkspace-baronly when the bar actually changed, so the loop settles instead of re-triggering itself. - Hand it to your agents. Because renaming is a plain IPC action, an automation agent can name workspaces after the windows you place on them, so the bar keeps describing what each workspace holds.
- Renames neither trigger a layout pass nor drop runtime monitor overrides from
move-to-monitor --force. The CLI reference documents the action and its wire shape.
Fixes and Improvements
- Switching between windows of the same app is immediate again in Niri layouts. Keyboard focus now moves to the target column right away instead of about 100 ms later, matching in-column navigation and Dwindle. #655
- Settings, App Rules, and other OmniWM windows no longer crash on macOS 27 betas for users whose region uses a comma as the decimal separator (German, French, Portuguese, and others). The built-in terminal's startup had switched the process's numeric locale, which broke symbol rendering in those regions; the terminal's own shell locale is unchanged. #576
Documentation
- Installation docs lead with the official Homebrew cask only and include the tap migration steps.
- The Nix section documents the official nixpkgs package and the Home Manager
programs.omniwmmodule. - The Compatibility, Requirements & Limitations page now covers supported Macs and macOS versions, permissions, the Spaces requirement, launch conflicts, and current limitations.
- omacosy, an Omarchy-inspired macOS desktop setup that supports OmniWM, now leads the community integrations list.
Website and documentation ยท Installation guide
Release Integrity
The OmniWM app is Developer ID signed, Apple-notarized, stapled, and Gatekeeper verified.
OmniWM-v0.6.8.zipSHA-256:0823963c8a5c3bde854f7fdd03cd8c25c4421a40bd6f74844f2c8f7c16a26765GhosttyKit.xcframework-v0.6.8.zipSHA-256:db543774b853ac0b051daa784ce8907a3101856ba3e5e65757da492b32d61e57