CURRENTMUSICX / GUIDE

把音乐交给日常。

从第一次安装，到连接自己的音乐库，这份指南帮你找到合适的听歌方式。

快速开始

前往 GitHub Releases，下载 CurrentMusic-Android-v版本号.apk。正式包适用于 Android 8.0 及以上的 ARM64 设备。
按 Android 系统提示安装；首次安装可能需要允许浏览器或文件管理器「安装未知来源应用」。同签名正式版可覆盖升级。
打开「设置 → 网络与播放」，分别选择音乐音源和歌词来源。
按需登录 CurrentMusic、绑定网易云，或在「我的 → 自建曲库」连接 Navidrome，然后搜索并播放第一首歌。

音乐音源与歌词来源是两项独立设置。希望都直连网易云时，需要同时选择「网易云原生」和「网易云歌词」。

在「设置 → 网络与播放」调整。切换歌词来源后，应用会重新加载当前歌词，并按来源隔离缓存。

CurrentMusic 默认服务器为 https://music.20110208.xyz/cm/，可在设置中更换。网易云原生音源不会自动回退到服务器取流；具体音质和可播放歌曲取决于服务与账号权限。

支持扫码和手机验证码登录。本机登录后，可直连搜索、歌单、收藏、推荐与评论；没有本机登录时，部分服务可以复用 CurrentMusic 账号的云端绑定，云端凭据不会下载到本机。

「网易云作为主音乐库」决定默认音乐库入口，「设置 → 网络与播放 → 默认红心位置」独立控制收藏目标。切换音乐库不会删除已有歌单。

私人漫游支持默认、熟悉、探索、拼图与动态场景，在原播放器中切换并连续推荐，结束后可以恢复原队列。

在「我的 → 自建曲库」配置自己的服务器并登录，浏览专辑、艺术家和收藏，也可搜索与原音质播放。歌曲直接从你的 Navidrome 服务器取流，收藏也保存到该服务器。

Navidrome 私有曲库目前仅在本机播放，不参与 CurrentMusic 房间或 DLNA 投屏。

网易云原生一起听支持邀请与短链接，复用原有搜索和播放队列，双方共享队列并同步切歌。可以管理队列、收藏歌曲，并查看一起听记录、排行和报告；可用内容受服务端权限限制。

冷启动会尝试恢复中断的会话；如果启动时主动开始其他播放，会取消本次自动恢复。结束会话后，应用会在确认远端结束后展示报告。

CurrentMusic 服务器房间另支持密码、点歌审批和成员权限。

支持 LRC、YRC、TTML，提供逐字高亮、翻译与罗马音，可调整字体、字号和歌词偏移。莫奈、流烟、星尘与透视效果让歌词随旋律流动。

优先采用真实逐字时间。卡拉 OK 兼容策略设为「总是」时，可以为普通逐行歌词生成近似高亮；这属于本地显示效果。

桌面悬浮歌词需要系统悬浮窗授权，支持调整位置、字号、翻译与锁定。应用内不常驻显示歌词 / FPS 灵动岛，仅临时显示音效、下载与错误反馈。

完整设置与说明见桌面歌词文档 ↗。

在「设置 → 检查更新」查看新版本，可以调整启动检查、更新渠道和下载来源。后台下载支持取消、重试与换源，安装包会进行大小、SHA-256、包名和签名检查，最后由 Android 系统确认安装。

下载音乐时可选择音质和保存目录，查看后台进度；歌曲信息、封面与歌词会写入音频文件，同时保存配套 LRC 和封面。Android 10 及以上默认目录为 Download/CurrentMusic，也可使用系统文件夹选择器另行授权。

为什么切换音乐音源后，歌词没有一起切换？

音乐与歌词来源独立设置。进入「设置 → 网络与播放」分别选择；希望全部直连网易云时，同时选择「网易云原生」和「网易云歌词」。

自己构建的安装包能直接覆盖正式版吗？

签名不同就无法直接覆盖。开发测试应使用独立测试包，与日常安装分开。详见构建与设备测试。

为什么部分歌曲、音质或音效不可用？

可用性取决于对应服务、账号权限与会员权益。应用内置适配的 ARM64 音效引擎，无需另装网易云；未接入的算法会明确提示。

如何反馈问题？

到 GitHub Issues 提供版本号、手机型号、Android 版本、复现步骤与现象。可从设置导出诊断日志，分享前检查并遮挡个人信息。

本指南依据当前源码与仓库文档整理。已发布版本的具体变化请查看更新记录。