HyprMac：macOS 平铺窗口管理器

项目简介

HyprMac 是一款面向 macOS 的键盘优先平铺窗口管理器，设计灵感来自 Linux 上的 Hyprland。打开应用后窗口会自动排成整齐的平铺布局，不需要手动拖拽和缩放；按住 Caps Lock（默认作为 Hypr 键）配合方向键、数字键即可完成窗口切换、交换和工作区跳转。项目免费开源，采用 MIT 许可证。

主要功能

• 自动平铺：新窗口打开即插入布局，采用与 Hyprland 默认一致的 BSP dwindle 算法，Hypr + J 可翻转分割方向。
• 键盘驱动：Caps Lock 默认映射为 Hypr 键，方向键切换焦点、加 Shift 交换窗口、数字键切换工作区。
• 快捷键总览：Hypr + K 呼出全部快捷键列表，忘记组合键时可随时查看。
• 十个工作区与总览：Hypr + 1–9 / Hypr + 0 切换工作区，Hypr + O 打开工作区总览，另有 scratchpad 暂存区。
• 多显示器支持：Hypr + Ctrl + 方向键 把窗口移到相邻显示器，Hypr + Ctrl + Shift + 方向键 调整窗口尺寸。
• 保存与恢复布局：Hypr + Ctrl + S 保存当前显示器配置下的布局，Hypr + Ctrl + R 恢复；显示器变化前后也会自动保存与还原。
• 应用固定工作区：在设置中把某个应用固定到指定工作区，它的每个新窗口都会开在那里。
• 自定义按键：Hypr 键可选 Caps Lock、反斜杠、F13–F20、Option 或 Command；任意组合键都可绑定到自己的程序或脚本。
• 配置文件：所有设置保存在 ~/Library/Application Support/HyprMac/config.json，格式为 JSON。

常用默认快捷键：

安装与使用

通过 Homebrew 安装：

brew trust --cask zacharytgray/hyprmac/hyprmac
brew install --cask zacharytgray/hyprmac/hyprmac

也可以下载 HyprMac.dmg，打开后把 HyprMac 拖入「应用程序」。首次运行请参考官方的安装指南完成权限与系统设置。

从源码构建：

git clone https://github.com/zacharytgray/HyprMac.git
cd HyprMac
brew install xcodegen
xcodegen generate

更新由 Sparkle 自动检查并提示安装；Homebrew 安装的版本可执行 brew upgrade --cask hyprmac。

注意事项

• 需要 macOS 13（Ventura）或更高版本，并在「系统设置 → 隐私与安全性 → 辅助功能」中授予权限；HyprMac 只使用辅助功能 API，无需关闭系统完整性保护（SIP）。
• 使用默认的 Caps Lock 作为 Hypr 键时，需在「系统设置 → 键盘 → 键盘快捷键 → 修饰键」中把 Caps Lock 保持为「⇪ Caps Lock」，而不是「无操作」。
• macOS 并未开放窗口管理的公开接口，部分应用可能不配合，偶尔出现窗口行为异常，可在 Issues 中反馈。
• Hypr + F 不会使用 macOS 原生全屏（会新建 Space 破坏布局），而是把窗口放到该显示器的独立空工作区。
• 每次更新后签名变化，macOS 可能要求重新授予辅助功能权限。

本作品整理自 GitHub 开源项目 zacharytgray/HyprMac，原作者 @zacharytgray，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。