OmniWM
BarutSRB and OmniWM contributors · 适用于 Apple Silicon Mac 的免费平铺式窗口管理器，支持滚动和 Dwindle 布局、工作区、多显示器控制及本地 CLI 自动化。
OmniWM 是一款系统工具类 Mac 应用。需要 macOS 26 或更高版本。
介绍
OmniWM 是一款面向 Apple Silicon Mac 的免费开源平铺式窗口管理器。它可使用 Niri 风格的滚动容器或 Dwindle 二叉树布局排列应用窗口，并可按工作区选择布局，还提供键盘导航、多显示器路由和可选的本地命令行自动化。适合需要管理大量窗口并构建键盘驱动工作流的用户。
功能
- 为每个工作区选择滚动容器或 Dwindle 平铺布局。
- 使用可配置快捷键导航、调整大小、重新排序和移动窗口。
- 通过 Workspace Bar 在多个显示器间组织工作区。
- 为平铺或浮动窗口及其初始位置配置应用规则。
- 通过命令面板查找窗口、启动应用和搜索文件。
- 使用可选的 Overview 预览、暂存区、Quake 终端和剪贴板历史记录。
- 使用捆绑的 omniwmctl CLI 和本地 IPC 自动执行受支持的操作。
安装与要求
使用 brew install --cask omniwm 安装，或解压官方发布 ZIP，并将 OmniWM.app 移至 Applications。cask 还会将捆绑的 omniwmctl 命令链接到 Homebrew 的 bin 目录。OmniWM 需要 Apple Silicon 和 macOS 26 Tahoe 或更高版本；不支持 Intel Mac 和更早的 macOS 版本。Windows 和 Linux 不是受支持的应用平台。当前文档指出，部分可选功能（包括 Hidden Bar 隐藏功能）需要 macOS 27 或更高版本；这并不意味着所有功能的核心平铺要求都提高到了该版本。
开始前，请在“系统设置”>“桌面与程序坞”>“调度中心”中启用“显示器使用单独的空间”。如果更改了此设置，请注销后重新登录。禁用该选项时，OmniWM 会暂停窗口管理。发布者建议每台显示器使用一个原生空间，并在 OmniWM 中设置工作区，以获得最清晰的行为；位于非活动原生空间中的窗口仍由 macOS 控制，直到该空间变为活动状态。
权限与安全
启动时需要“辅助功能”和“输入监控”权限：这些权限允许发现、聚焦、移动和调整窗口大小，并接收全局输入快捷键。这些权限可提供广泛的控制能力；只应授予可信的应用副本，并在 macOS 设置中检查权限。
“屏幕录制”为可选权限，可启用基于捕获的视觉效果，例如 Overview 缩略图、拖动预览和捕获的菜单栏图标。没有此权限仍可进行平铺，但视觉预览会减少，且壁纸回退行为会有所不同。“完全磁盘访问权限”为可选权限，供 Hidden Bar 使用；基本平铺不需要此权限。当前文档将该功能额外的系统要求与常规窗口管理要求区分开来。
官方版本经过 Developer ID 签名并由 Apple 公证；发布者表示可以保持系统完整性保护（SIP）启用。普通安装官方版本时请勿关闭 SIP。OmniWM 使用部分 Apple 私有 API 以及公共框架；未来 macOS 的变化可能影响兼容性。
冲突、配置与自动化
请勿同时运行其他常驻窗口管理器。OmniWM 会检查 AeroSpace、Amethyst、yabai、Nehir 等竞争管理器；检测到冲突时，在冲突程序退出前不会启动窗口管理。cask 本身未列出其他公式依赖项，也未列出明确冲突的 cask 条目；应用运行时的冲突检查是另一项限制。
普通发行版包含应用及其 CLI；从源代码构建则有单独的开发要求。可选的终端、状态栏和社区集成并非基本平铺功能的可互换依赖项。请确保 omniwmctl 和自定义 IPC 客户端与应用版本一致：0.7.5 将 IPC 协议更改为 18，并将默认套接字移至用户主文件夹中的 Library/Application Support/com.barut.OmniWM/ipc.sock，其旁还存有身份验证密钥。请保护该密钥，并仅授权可信的本地自动化。为自动化配置的 Shell 命令可以使用用户权限执行代码。
设置存储在 ~/.config/omniwm/settings.toml 中。测试较新版本或降级前，请备份配置：0.7.4 会将其迁移到架构 4，并保留一份 v4 之前的备份；重写配置会移除注释。暂存区标签会保留，但当前文档说明窗口成员关系仅在进程运行期间有效。原生全屏模式和应用最小尺寸可能限制管理行为。
剪贴板历史记录为可选功能，默认关闭；只有在保留复制数据符合隐私需求时才启用。诊断报告可能包含设置、应用/窗口标题以及基于标题的规则。公开附上报告前请先检查。应用可准备 GitHub issue，但不会获取您的 GitHub 登录信息；报告功能与本地操作相互独立。
费用、账户与更新
OmniWM 免费，采用 GPL-2.0-only. 许可。捐赠为可选项；本地窗口管理无需购买、订阅或账户。捆绑组件各自有其声明。当前文档中的可选 AI 辅助 issue 报告改写功能需要 macOS 27、已启用的 Apple Intelligence 以及可用的本地模型；不使用该功能仍可手动报告。
本地窗口排列不需要云账户。默认更新检查会在启动时联系 GitHub，每天最多一次；更新需要手动操作，不会自动下载或安装。替换应用包前请退出应用，然后重新启动；如有需要，请再次检查权限。Canary 版本可能存在回归，不应与目录中的稳定版本混淆。
根据 HTTP HEAD 元数据，官方 0.7.5 ZIP 大小为 19,837,372 字节；安装后的存储占用以及状态/配置数据占用各不相同。
新版本 0.7.6 更新内容 10月8日 · OpenNavo 编辑 · AI 翻译
- 手势应用中的双指滚动恢复正常
- 栏与焦点工作区栏可自动隐藏；安全输入时显示红锁
- 升级列滚动现在需要三指或四指
安装与卸载
Homebrew 会把应用安装到“应用程序”文件夹。
不用 Homebrew 安装
直接下载 Homebrew 使用的同一个文件： github.com/OmniNull/OmniWM/releases/download/v0.7.6/OmniWM-v0.7.6.zip
SHA-256 只用来核对下载的文件是否完整，不代表安全认证。 查看 SHA-256 和下载地址
$ brew uninstall --cask omniwm普通卸载会删除应用本身，设置和缓存会保留。
$ brew uninstall --zap --cask \omniwm--zap 还会删除 Homebrew 定义里列出的设置、缓存等文件，其中可能有其他应用共用的数据，删除后无法恢复；它也不保证没有任何残留。查看会删除哪些文件
资料与来源
- 版本 0.7.6
- Homebrew 记录于 10月8日厂商发布于 10月8日
常见问题
OmniWM 安全吗？
OmniWM 收录在 Homebrew 官方软件库中，没有被停用。自 2026 年 9 月起，Homebrew 会停用没有通过 macOS Gatekeeper 检查的应用。安装时，Homebrew 会用 SHA-256 校验值核对来自 github.com 的安装包。过去 30 天，它通过 Homebrew 安装了 1,099 次。
OmniWM 是开源软件吗？
OmniWM 的源代码公开在 GitHub 上（OmniNull/OmniWM），使用 GPL-2.0 许可证。
怎样在 Mac 上彻底卸载 OmniWM？
运行 brew uninstall --cask omniwm。要连设置和缓存一起删除，运行 brew uninstall --zap --cask omniwm。这会再删除 5 处文件和文件夹，包括 ~/。
OmniWM 支持 Apple 芯片（M1 及更新）的 Mac 吗？
支持，而且只能安装在 Apple 芯片的 Mac 上，不支持 Intel 芯片的 Mac。需要 macOS 26 或更高版本。
OmniWM 的设置和数据保存在哪里？
设置保存在 ~/。数据保存在 ~/。这些位置来自 Homebrew 的清理清单。
OmniWM 的最新版本是多少？
最新版本是 0.7.6，Homebrew 收录于 10月8日。运行 brew upgrade --cask omniwm 即可更新。
安装 OmniWM 还会装上什么？
还会装上 1 个命令行工具：omniwmctl。