Kairo Music

网易云曲库 + Apple Music AAC 音源的桌面播放器

Kairo Music 是由 hayhay0124 维护的开源桌面音乐播放器。它以网易云音乐作为内容发现和曲库主体，并提供 Apple Music 音源匹配能力。

当前版本是 Windows x64 实验版。Apple Music 目前只提供 AAC 256 kbps，不提供 ALAC 无损或 Hi-Res。无损播放需要后续集成 Wrapper-v2，当前版本不应被当作 Apple Music 无损客户端使用。

当前功能

• 网易云音乐主页、搜索、推荐、歌单、收藏和播放队列。
• Apple Music 登录、曲目匹配和 AAC 256 kbps 播放。
• Apple Music 匹配失败、登录失效或准备失败时回退网易云。
• 本地音乐库、歌词、封面、播放统计和歌单管理。
• Windows 原生音频引擎、WASAPI、均衡器、DSP 和音频诊断。
• 内置 Provider 与可选插件扩展。

界面预览

更多界面截图位于 assets/screenshots。

Apple Music 当前边界

当前 sidecar 使用 gamdl 的 AAC_WEB 路径：

AAC · 44.1 kHz · 256 kbps

这属于有损音频，不是 ALAC 无损。界面中的 Hi-Res 项目前为禁用状态。

普通无损和 Hi-Res 无损都使用 Apple Music 的 ALAC/FairPlay 链路。在当前 gamdl 实现中，稳定处理 ALAC 需要 Wrapper-v2；Wrapper-v2 运行在 Linux/chroot/Android Native 环境，不能直接作为 Windows 单文件组件分发。

后续方向

下一阶段计划是 Linux Gateway，而不是继续把 Wrapper-v2 强行塞进 Windows 安装包：

浏览器或桌面客户端
          ↓ HTTPS
Kairo Music Gateway
          ├─ 网易云目录与匹配
          ├─ gamdl
          ├─ Wrapper-v2
          └─ ALAC 缓存与 Range 播放

Gateway 将在 Linux 上完成 Apple Music 登录、FairPlay 解密和缓存，客户端只接收最终音频。这样可以避免把 Wrapper 的原始 HTTP/TCP 解密端口暴露到公网，也能减少远程解密产生的双向音频流量。

下载

Windows 安装包位于 GitHub Releases。当前版本只适合体验网易云主程序、本地音乐功能和 Apple Music AAC 音源。

应用内更新流程会读取公开 GitHub Releases，比较版本号，选择 Windows setup.exe，下载后校验 SHA-256，校验通过才启动安装程序。

开发

corepack pnpm install
corepack pnpm run dev

构建 Windows 版本：

corepack pnpm run build:apple-music-sidecar
corepack pnpm run build
corepack pnpm exec electron-builder --win

网络与安全

• 不要把 Wrapper-v2 的 HTTP 端口或 TCP 解密端口直接暴露到公网。
• 个人部署建议使用 Tailscale/WireGuard，或仅暴露经过 HTTPS 认证的 Gateway。
• Apple ID、密码、2FA、media-user-token 和 Wrapper 会话不得写入普通日志。
• Apple Music 原生库需要由部署者自行准备；本项目不分发 Apple 专有二进制文件。

项目来源

Kairo Music 基于以下开源项目继续开发：

• 主程序原仓库：asenyarzc-cpu/Twilight_Echo
• Apple Music 工具原仓库：glomatico/gamdl
• Wrapper-v2：glomatico/wrapper-v2

原项目及第三方依赖的著作权和许可证归各自作者所有。Apple Music 商标和服务归 Apple Inc. 所有。本项目与 Apple Inc. 没有官方隶属或背书关系。

许可证

本项目沿用 Apache License 2.0。