Boring Notch 快速上手：3 步装好，把 MacBook 凹口变成音乐播放器和快捷面板
项目地址: https://gitcode.com/gh_mirrors/bor/boring.notch 视频会开始前，你想暂停音乐、确认下一场会几点，又不想在三个窗口间来回切。Boring Notch 把 MacBook 顶部那块凹口变成了一个随叫随到的面板：悬停它，播放器、日程、电量就展开在眼前，移开鼠标自动收起。
先跑起来：环境要求与 3 种安装方式
环境要求
- macOS 14 Sonoma 或更新（源码编译则需要 15.6 及以上、Xcode 26 及以上）
- Apple Silicon 或 Intel 的 Mac
- 带凹口的 MacBook 最贴合；接外显时会自动改按菜单栏高度对齐
3 种安装方式怎么选
| 安装方式 | 适用人群 | 难度 |
|---|---|---|
| Homebrew 一行命令 | 已装 Homebrew，想最省事 | 低 |
| DMG 拖进 Applications | 没装 Homebrew，或想手动挑版本 | 低 |
| 源码编译 | 要读改源码的开发者 | 高 |
Homebrew 装法会自动跳过后面那道安全警告，是三选一里最干净的一条路。
从安装到首次启动
- 三选一装上：
- Homebrew：
brew install --cask TheBoredTeam/boring-notch/boring-notch - DMG：打开 .dmg，把 Boring Notch 拖进 /Applications（完整步骤见 README）
- 源码：
git clone https://gitcode.com/gh_mirrors/bor/boring.notch，用 Xcode 打开 boringNotch.xcodeproj，按 Cmd+R 运行
- Homebrew：
- 首次打开会被"未受信任的开发者"拦下——官方还没有 Apple 开发者账号，属正常现象，放行一次即可：
- 最稳是终端跑
xattr -dr com.apple.quarantine "/Applications/Boring Notch.app" - 或 系统设置 > 隐私与安全性，拉到底点"仍要打开"（个别账户不生效，就换终端法）
- 最稳是终端跑
- 再打开，屏幕顶部凹口出现 Boring Notch 默认界面，菜单栏多出一个星形图标，点开进设置。
首次启动：权限与音乐来源
第一次运行会弹一个引导窗，按顺序问 5 项，用不上的点 "Not Now"，对应功能就关掉（权限项和顺序见 onboarding 源码）：
- 相机：凹口里"镜子"自拍预览用，不需要可跳
- 日历：把接下来的日程显示在凹口
- 提醒事项：把定时提醒和日程并排列出
- 辅助功能：替换系统音量/亮度 HUD 才需要，不给就用默认 HUD
- 最后选一个音乐来源：Now Playing、Spotify、Apple Music、YouTube Music
5 个日常场景：看它替你干什么
听歌时 🎧
鼠标悬停到凹口，播放器连同专辑封面和跳动的可视化一起展开。不切窗口就能切歌、拖进度、开歌词（设置里可开），点封面还能直接跳回对应播放器 App。
会前盯日程时
展开凹口切到日历页，接下来的会议和提醒事项按时间排在最上面。不打开日历 App 就知道下一场几点开始，避免错过。
想传文件时 📁
把文件直接拖向屏幕顶部中央，Shelf 会自动展开并接住它。在 Shelf 上就能 AirDrop 或丢给常用 App，传完文件不用切去访达。
盯系统状态时 🔋
按音量或亮度键，凹口处弹出滑块代替系统 HUD（前提是给了辅助功能权限）。电量百分比和充电状态也常驻在凹口，一眼看到。
会前整理形象时
打开设置里的"镜子"，摄像头实时预览就挂在凹口上。会前瞄一眼妆发不用切摄像头 App，移开鼠标即关。
5 个不踩坑就不知道的操作细节
这些开关都在 设置源码 里，设置窗口也按这个顺序排：
- 鼠标悬停约 0.3 秒凹口才展开，移开即收起。时长和灵敏度都能调，手抖党把阈值拉高就不容易误触。
- 按 Cmd+Shift+I 开/合凹口，Cmd+Shift+H 显示 3 秒后自动收起（叫 Sneak Peek）。不展开面板也能瞟一眼封面和歌词。
- 把文件拖进屏幕顶部中央区域，Shelf 会自动展开接收。拖拽范围由 expandedDragDetection 控制，默认开着，关了就只认凹口本身。
- 按住 Option 再按媒体键，行为可配成打开系统设置或显示 HUD。一个组合键两种用法，不习惯就设成无动作。
- 设置里打开"在所有显示器显示"，每个屏幕的凹口都会出现一份面板；外显没有凹口，会按菜单栏高度自动贴合。
4 个常见坑：现象、原因、解决办法
- 现象：双击打开，提示"未受信任的开发者"或"已损坏"。原因：应用没有 Apple 开发者签名（官方还没有开发者账号），且带系统隔离标记。解决办法：终端跑那行 xattr 命令，或系统设置"仍要打开"，做一次即可。
- 现象：音乐信息不显示，控制按钮点了没反应。原因：音乐来源没配对，或 Now Playing 在当前 macOS 版本已被弃用。解决办法：设置 > Media 换成 Spotify 或 Apple Music；用 YouTube Music 需要第三方客户端并开启 API 插件。
- 现象：按音量/亮度键，还是系统旧 HUD，没变成凹口样式。原因：没给"辅助功能"权限，Boring Notch 拦截不到媒体和亮度事件。解决办法：回到引导窗或系统设置补授权辅助功能。
- 现象：文件拖到顶部，Shelf 不展开、不接收。原因：要拖到屏幕顶部中央的凹口区域，不是任意位置；或 Shelf / expandedDragDetection 被关了。解决办法：对准顶部中央再拖，确认设置里 Shelf 是开的。
适合谁用，接下来做什么
Boring Notch 适合带凹口 MacBook、想少切窗口的人，把音乐、日程、电量和文件分享都收到屏幕最上方。先按上面任一方式装上，引导里选好音乐来源，再用 Cmd+Shift+I 试几次开合，基本就能上手。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
