volumeHUD：macOS 经典音量 HUD 恢复工具

项目简介

volumeHUD 是一个用 Swift 编写的 macOS 应用，用来恢复经典的音量与亮度 HUD（屏幕中央弹出的指示条）。macOS Tahoe 改版控制中心后，苹果把沿用 25 年的音量、亮度指示器换成了屏幕角落的小浮窗，甚至比通知还小，在浅色背景上很难看清，消失得也快。

作者于是自己动手写了这个应用：拦截音量与亮度按键，由自己处理变化并绘制经典样式的 HUD，同时隐藏系统自带的 HUD。项目采用 MIT 许可证开源。

主要功能

• 恢复经典的音量 HUD 样式，调节后显示变化再自动消失
• 支持内置显示器的亮度 HUD（默认关闭，需在设置中开启）
• 通过拦截音量 / 亮度按键自行处理，从而隐藏系统原生 HUD
• 4.0 版本新增 Modern HUD 风格，采用 Liquid Glass 玻璃元素，配色更柔和、圆角更大，并带有缩放、模糊、淡入淡出的进出动画
• 重新设计的应用图标，以及采用原生 macOS 设置窗口风格重新设计的「关于」窗口

安装与使用

推荐通过 Homebrew 安装，这样后续更新也由 Homebrew 负责：

brew install dannystewart/apps/volumehud

卸载命令：

brew uninstall volumehud

启动应用后会看到一条已启动的通知，随后即可正常使用。再次启动会打开设置窗口，可以在其中检查更新或退出应用。

注意事项

应用无需任何权限即可运行，但会请求两项可选但推荐的权限：

• 通知：仅用于确认应用已启动，且只在手动启动（而非作为登录项启动）时发送，可自行关闭。
• 辅助功能：完整功能需要它。缺少该权限时，系统 HUD 仍会与应用 HUD 同时出现；音量为 0% 以下或 100% 以上时 HUD 不会显示；亮度检测也可能不够可靠。

遇到行为异常时，多半是辅助功能权限问题，建议彻底卸载后重装，并从「系统设置 → 隐私与安全性 → 辅助功能」中移除 volumeHUD 后重新授权。也可以用命令行重置：

pkill -f volumeHUD
tccutil reset Accessibility com.dannystewart.volumehud

作者说明这是一个个人项目，不接受 PR 或功能请求。

---

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