为刘海 Mac 打造的原生音乐灵动岛
在屏幕顶部查看正在播放、同步歌词与常用状态，需要时展开，用完自然收起。
Notchly 是一款本地优先的 macOS 应用，把音乐信息、同步歌词和少量日常状态放在 MacBook 刘海附近。它使用 SwiftUI 与 AppKit 构建，支持多桌面和真实刘海定位，不读取屏幕内容或系统音频。
- 显示歌曲、歌手、封面、播放进度，并提供上一曲、播放/暂停和下一曲控制。
- 支持 Apple Music、Spotify，以及网易云音乐、QQ 音乐、酷狗、酷我和汽水音乐的系统媒体会话。
- 播放器能力使用可注册适配器：Apple Music 与 Spotify 走公开 AppleScript 通道，国内播放器使用独立的 MediaRemote 兼容层。
- 从网易云音乐和 LRCLIB 匹配同步歌词，支持歌词源自带译文、本地缓存与 ±3 秒校准。
- 桌面歌词支持单行居中、双行居中滚动与 KTV 左右交替，并提供进度覆盖色、主题、字号和背景透明度设置。
- 提供有界的最近播放与歌曲收藏：最近播放最多 50 首、收藏最多 100 首，均只保存在本机。
- 提供频谱、波形、脉冲和“宇宙尘埃”四种本地模拟动效。
- 支持专注计时、喝水与久坐提醒，以及电池和下一日程展示。
- 电池、专注、日历、提醒事项和文件暂存使用统一模块注册表；核心入口固定启用并采用稳定的默认顺序。
- 提供工作、音乐、演示和省电场景预设；手动修改关联设置后自动回到自定义模式。
- 支持临时文件拖入、Finder 定位、保存期限、容量上限和一键清空。
- 可通过鼠标悬停、菜单栏图标或全局快捷键展开和收起。
- 收起状态可选智能、时间或极简模式；同步歌词保留在展开播放器与独立桌面歌词中。
- 多显示器环境可选内建屏优先、主屏或随鼠标移动，无刘海外屏使用顶部虚拟岛。
- 默认在其他应用进入 macOS 全屏空间时自动隐藏，也可在设置中关闭。
- 可复制匿名诊断信息与反馈模板，用于排查长时间运行、内存和播放器通道问题。
Notchly 需要 macOS 14.0 或更高版本。
前往 GitHub Releases 下载最新版本：
- DMG（推荐）：打开安装镜像，将
Notchly.app拖入“应用程序”文件夹。 - ZIP：解压后，将
Notchly.app移入“应用程序”文件夹。
也可以从 Notchly 官方网站 进入下载页面。
当前发行包尚未完成 Developer ID 签名和 Apple 公证。若 macOS 首次启动时拦截应用，可在 Finder 中右键选择“打开”，或前往“系统设置 → 隐私与安全性”确认打开。仅从上述官方页面下载发行包。
| 动作 | 操作方式 |
|---|---|
| 展开或收起 | 悬停刘海、点击菜单栏图标，或按 ⌘⇧Space |
| 控制播放 | 使用上一曲、播放/暂停和下一曲按钮 |
| 返回播放器 | 点击专辑封面 |
| 收藏和播放记录 | 点击播放器中的爱心收藏；点击历史图标查看最近播放与收藏 |
| 校准歌词 | 使用歌词右侧校准控件，或在设置中调整时间偏移 |
| 管理文件暂存 | 将文件拖入“文件暂存”区域后打开入口 |
| 提交反馈 | 在“关于”页复制反馈模板，再通过 GitHub Issues 提交 |
| 打开设置 | 展开灵动岛后点击右上角齿轮 |
Notchly 不提供账号、广告、遥测或自建数据收集服务。设置、歌词缓存、最近播放、歌曲收藏、专注状态和文件暂存均保存在本机。完整数据边界见 隐私政策。
对应功能首次使用时，macOS 可能请求以下权限：
- 日历：读取下一场非全天日程，仅在岛内展示。
- 提醒事项：仅在启用并主动打开提醒卡片后读取下一条未完成提醒。
- 自动化：读取和控制已运行的 Apple Music 或 Spotify。
- 通知：发送专注、喝水和久坐提醒。
- 网络访问：匹配同步歌词和加载远程专辑封面。
- 文件访问：仅处理用户主动拖入文件暂存区域的项目。
Notchly 不读取键盘输入、屏幕内容或系统音频，也不需要屏幕录制权限。
- 国内播放器兼容层使用私有
MediaRemote.framework，当前版本不适合直接提交 Mac App Store。 - AppleScript 与 MediaRemote 已在代码层隔离；关闭或替换兼容层不会影响 Apple Music、Spotify 和灵动岛核心界面。
- 歌词和远程封面的可用性、准确性及内容授权由相应第三方服务决定。
- 文件暂存用于临时周转，不替代长期存储；请保留重要文件的原始副本，并通过 GitHub Issues 反馈问题。
需要 macOS 14.0+、Xcode 16+（Swift 6）和 XcodeGen。
git clone https://github.com/lglglglglg/Notchly.git
cd Notchly
./scripts/package-stable.sh构建产物位于 dist/，包括 Notchly.app、DMG 和 ZIP。签名、公证与正式发布流程见证书与发布说明。
本项目在 LINUX DO 社区进行开源，感谢社区佬友的交流、反馈与推广建议。
- MediaRemoteAdapter — 提供 macOS MediaRemote 媒体状态与播放控制兼容能力，采用 BSD-3-Clause License。
- 感谢 ungive/mediaremote-adapter 对 macOS MediaRemote 兼容方案的探索与开源贡献。
完整许可证与版权声明见 THIRD_PARTY_NOTICES.txt。
Notchly 基于 MIT License 开源。
© 2026 Stephan Li · 韩十久工作室（Hanshijiu Studio）