macOS 鼠标侧键映射工具
将鼠标侧键映射为系统音量或屏幕亮度控制
- 🖱 鼠标侧键映射 — 将前进/后退侧键映射为自定义功能
- 🔊 音量控制 — 侧键一键调节系统音量，带原生 OSD 显示
- ☀️ 亮度控制 — 侧键一键调节屏幕亮度，带原生 OSD 显示
- 📌 菜单栏运行 — 无 Dock 图标，仅在菜单栏显示
- 💾 配置持久化 — 映射设置自动保存
- 🚀 开机自启动 — 支持设置系统登录时自动启动
菜单栏下拉菜单，支持独立配置每个侧键的映射功能：
| 功能 | 图标 |
|---|---|
| 音量增大 | speaker.wave.3.fill |
| 音量减小 | speaker.wave.1.fill |
| 亮度增大 | sun.max.fill |
| 亮度减小 | sun.min.fill |
- macOS 13.0+
- Xcode Command Line Tools (
xcode-select --install)
# 克隆项目
git clone https://github.com/kadevin/Mouse-ctrl.git
cd Mouse-ctrl
# 开发调试
swift run
# 打包为 .app
bash build.sh打包后的应用位于 build/MouseCtrl.app，可直接双击运行或拖到 /Applications 安装。
MouseCtrl 需要 辅助功能权限 来监听鼠标侧键事件：
- 首次运行时系统会弹出权限请求
- 前往 系统设置 → 隐私与安全性 → 辅助功能
- 找到 MouseCtrl 并打开开关
| 模块 | 技术 |
|---|---|
| 鼠标监听 | CGEvent.tapCreate 捕获 otherMouseDown |
| 音量/亮度 | 模拟系统媒体键事件 (NX_KEYTYPE) |
| 配置存储 | UserDefaults |
| 开机自启 | SMAppService (macOS 13+) |
| 菜单图标 | SF Symbols (单色模版图标) |