Windows 有音量合成器,macOS 没有 —— 补上这一块。
QQ 30% · 微信 60% · 音乐 100% · 提示音静音 —— 互不影响
make install && make autostart或从 Releases 下载 DMG,双击「安装.command」
| 每 App 独立音量 | QQ 调 30%、微信调 60%、音乐 100%,互不影响 |
| 系统提示音单独控制 | 消息提示音/警告音走的是系统服务,不归 App 管 —— PerAppVol 把它做成独立一路,夜里静音提示音、保留通话 |
| 全部静音 / 逐个静音 | 一键勿扰 |
| 实时电平表 | 每行滑块下有电平条,一眼看出是哪个 App 在出声 |
| 输出设备热切换 | 蓝牙耳机断开、换显示器,自动跟着切,设置不丢 |
| 设置持久化 | 按 bundle ID 记忆,App 移动/重装/更新都不丢;App 启动自动应用 |
| 开机自启 | 常驻菜单栏,挂了自动拉起 |
| 链接式限幅器 | 多 App 叠加过载时自动压限,不爆音 |
| CPU | Apple Silicon (arm64) |
| 系统 | macOS 14.2 或更高 |
| 权限 | 「屏幕与系统音频录制」(首次运行时引导授权) |
暂不支持 Intel Mac(无 x86 测试环境,不做未经验证的构建)。
方式一:下载 DMG
- 从 Releases 下载
PerAppVol-<版本>-arm64.dmg - 双击 DMG → 双击 「安装.command」
- 首次运行:系统设置 → 隐私与安全性 → 屏幕与系统音频录制 → 打开 PerAppVol
为什么不能直接拖到 Applications?见下方 FAQ。
方式二:从源码构建
git clone git@github.com:crzliang/PerAppVol.git
cd PerAppVol
make install # 构建 + 装到 /Applications + 启动
make autostart # 开机自启装好后菜单栏会出现一个扬声器图标,点开就是音量面板。
- 拖滑块调该 App 音量(松手即时生效,支持拖动中实时跟随)
- 点右侧 − 把该 App 放回「其他所有 App」
- 全部静音一键勿扰
- 勾 开机自启让设置始终生效
典型用法:
| 场景 | 怎么调 |
|---|---|
| 开会时压掉背景音乐 | 音乐 App 拖到 20% |
| 夜里不想要提示音 | 系统提示音拖到 0% |
| 只想听清某个人 | 其他全部压低,他的 App 拉满 |
| 录屏时不想录进音乐 | 音乐 App 拖到 0% |
Q:为什么要授权「屏幕与系统音频录制」? PerAppVol 需要读取各个 App 正在播放的音频才能分别调节音量。这是 macOS 提供的标准接口(CoreAudio Process Taps)。不授权 = 抓不到音频 = 没有任何音量控制。音频只在本机处理,不上传、不录制。
Q:安装时提示「已损坏,无法打开」/「无法验证开发者」? 这是 Gatekeeper 对未公证应用的正常拦截。终端里执行一条命令解除:
xattr -cr /Applications/PerAppVol.app然后重新打开。(也可以右键 → 打开 → 再点「打开」。)
Q:为什么不能直接把 App 拖进 Applications? 因为那样装出来的 App 是未签名状态 —— macOS 不会把它列入隐私授权列表,永远拿不到授权,也就没有音量控制。「安装.command」会在你机器上生成一张本地签名证书并重签,这一步不能省。全程无需 Apple 开发者账号、无需管理员密码。
Q:调 QQ / 微信 / 飞书 的音量,为什么管不到消息提示音?
因为消息提示音不是 App 播放的 —— 系统通知的提示音由 systemsoundserverd 统一播放。PerAppVol 把它做成独立的「系统提示音」一路,单独调它就行。App 自己的音频(语音消息、视频通话、App 内音效)才归该 App 那一根滑块管。
Q:从旧版本(项目原名 mac-sound-control)升级,需要做什么?
跑一次 make install 就行(DMG 版双击「安装.command」)。迁移脚本会自动清掉旧版的足迹:
旧 bundle ID 的 App/TCC 记录、旧 LaunchAgent(它的 KeepAlive 会拉起第二个 App)、
旧 /tmp socket 与 PID(旧引擎不杀会和新引擎抢音频)、旧默认输出注册;
你的每 App 音量设置会一并迁移过来。
唯一要手动的一步:bundle ID 变了 = 新的隐私身份, 需要去 系统设置 → 隐私与安全性 → 屏幕与系统音频录制 把 PerAppVol 重新打开(旧的条目已经失效)。
Q:会不会有延迟? 端到端理论预算 ≤ 40ms(滑块命令合并 25ms + 音频回调 10ms + 少量调度)。日常听感无感。
Q:音频会被上传或录制吗? 不会。所有音频只在本机的混音引擎里处理,没有网络代码。
- 仅 Apple Silicon(Intel Mac 暂不支持)
- 仅本机输出,不支持按 App 路由到不同输出设备(计划中)
- 不支持音效/EQ,只有音量与静音
- 不能上 Mac App Store:音频 tap 与沙盒不兼容
- 分发给其他 Mac 需要 Developer ID 签名 + 公证(本机使用无需)
make # App + 命令行工具
make app # 只要 App → build/PerAppVol.app
make tools # 只要命令行工具 → build/{perappvol,apptap,volctl}
make icon # 重新生成图标
make dmg # 打包 DMG
make install # 装到 /Applications(自动迁移旧版 mac-sound-control 的残留)
make autostart # 开机自启
make cleansrc/engine/perappvol.m 混音引擎(CoreAudio tap / 聚合设备 / 渲染 / 限幅)
src/ui/PerAppVolApp.swift 菜单栏 UI(SwiftUI)
src/ui/Autostart.swift 开机自启(LaunchAgent)
src/tools/apptap.m 链路调试工具
src/tools/volctl.swift 系统总音量 / 设备切换
scripts/ 图标生成、开机自启、旧版命名迁移
.github/workflows/ CI + 自动发版
docs/ 技术笔记
发版:推 v* 标签即自动构建 + 发布到 GitHub Releases(.github/workflows/release.yml)。
技术实现、踩过的坑(28 条)、API 用法 → 见 docs/TECHNICAL.md。
