一款支持自定义音源、滚动歌词与本地音乐的 iOS 播放器。

下载 · 应用预览 · 开始使用 · 开发指南 · 反馈问题

CyMusic 将音乐浏览、播放、歌词和个人歌单放在一起，支持深色、浅色与跟随系统的外观。 当前 main 基于 Expo 57、React Native 新架构和 RNTP v5，保留原有 App 的主要功能。

音乐列表	正在播放	滚动歌词
个人收藏	歌单管理	按喜好设置

截图采自当前 iOS 构建（iPhone 17 Pro · iOS 26.5），使用演示歌单、封面与歌词。演示内容不随 App 分发，也不代表 App 内置音源。

在线内容、可用音质与播放结果取决于第三方平台和所配置的音源。

部分 FLAC 在快进后可能出现音频与歌词不同步，可在 设置 → 音频设置 → 精确跳转 中开启改善。该开关默认关闭，记住选择并在切换歌曲后生效；开启后部分音频可能需要 完整加载，播放前等待更久。

支持 iOS 16.4 及以上。

本 README 介绍 main 分支。Releases 与 main 可能处于不同版本；如需 Expo 57 / RNTP v5 版本，请选择对应的 main 构建。 Actions 产物是未签名 IPA，安装到真机前需要自己的有效签名和 App Group 配置。

1. 安装 App：从上方渠道获取对应版本，完成签名后安装。
2. 配置音源：进入设置 → 自定义音源 → 导入音源，选择本地脚本或输入脚本 URL。可参考 CyMusic 音源示例。
3. 整理音乐：在“收藏”中管理喜欢的歌曲、自定义歌单及本地/缓存歌曲；创建歌单或导入 QQ 音乐歌单。
4. 开始播放：选择歌曲，点击底部迷你播放器展开播放页；在歌曲菜单中打开歌词、收藏、添加到歌单或设置定时关闭。

首次导入的音源会自动选中。请使用可信且有权访问的音源，并尊重音乐作品的版权。

当前使用的工具链：Node 24.19.0 · Yarn 1.22.22 · CocoaPods 1.16.2 · Xcode 26.6。

git clone https://github.com/gyc-12/Cymusic.git
cd Cymusic

yarn install --frozen-lockfile --non-interactive
cd ios
pod _1.16.2_ install --deployment
cd ..

npx expo run:ios --no-install

自定义原生模块需要开发构建，不能在 Expo Go 中运行。仓库维护原有 ios/ 工程与分享扩展，不要运行 expo prebuild 覆盖原生工程。 请保留锁文件和安装时应用的补丁；原生依赖或补丁变更后需要重新构建 App。

• 完整开发指南：环境准备、原生补丁、Pods 配置恢复、Release 构建与专项检查。
• RNTP v5 集成记录：实现边界、验证结果与回退说明。
• 精确跳转验证：FLAC 跳转修复、加载取舍和复现方法。
• 第三方许可说明：播放器许可的版本、来源与适用范围。

欢迎通过 Issues 报告问题或提出建议，反馈时请附 App 版本、设备系统和复现步骤。 提交 PR 时请说明改动目的、影响范围与验证结果；涉及原生依赖时同步检查锁文件、补丁和 iOS 构建。 当前构建方式、专项检查和已知验证边界见开发指南。

项目动态：Telegram 频道。

• 自有源码：按 Apache License 2.0 授权。官方 App 的使用说明不修改 Apache-2.0 条款，也不撤销已有的源码授权。
• RNTP v5：@rntp/player@5.9.2 的版权属于 Double Symmetry GmbH，适用随该版本发布的独立许可证。RNTP v5 不属于 CyMusic 的 Apache-2.0 授权范围，不能因本项目开源而视其为 Apache-2.0 或 MIT 软件；CyMusic 不另行授予其商业使用或再许可权利。
• 官方 App：永久免费，仅限个人、非职业、非商业使用，禁止商业用途。免费不等于可以用于公司、组织或商业产品，RNTP 的具体授权条件以其原文为准。
• 其他依赖：保留各自的版权与许可证。

完整说明见 CyMusic 官方 App 使用说明。请尊重版权，支持正版音乐。

感谢这些项目提供的参考与启发：

• CodeWithGionatha-Labs/music-player
• lyswhut/lx-music-mobile
• maotoumao/MusicFree