歌单无界：在线歌单迁移工具

项目简介

歌单无界（LocalMusicHelper）是一款 Android 应用，用于把保存在网易云音乐、QQ音乐、酷狗音乐、酷我音乐、汽水音乐、Spotify 共 6 个在线音乐平台的歌单数据，转换成 Salt Player、APlayer、Poweramp 等本地音乐播放器可识别的歌单格式。也支持从 TuneMyMusic 生成的 CSV 歌单文件导入，并支持 Salt Player、APlayer、Poweramp 三个本地播放器歌单格式的相互转换。所有歌单数据转换均在本地完成，不上传无关数据。

本项目只提供歌单的迁移与转换功能，不具有音乐下载、传输、播放的能力，需要自行使用其他方式获取 flac、mp3、wav 等非加密格式的音乐文件。

主要功能

• 支持网易云音乐、QQ音乐、酷狗音乐、酷我音乐、汽水音乐、Spotify 的歌单数据，以及 TuneMyMusic 生成的 CSV 歌单文件。
• 支持输出 Salt Player、APlayer、Poweramp 可识别的歌单格式，并支持三者之间互转。
• 在 App 中登录音乐平台账号，可直接在线获取歌单数据，无需手动寻找数据库文件。
• 设备已有 Root 权限时，可使用 Root 权限自动获取歌单来源 App 的数据库文件。
• 扫描设备中的歌曲文件，支持导出数据库 .db 文件或文本 .txt 文件，以便在其他设备上继续转换。
• 保留原歌单的排序方式，不会因转换而改变排序。
• 提供简单的音乐标签编辑功能，并支持部分标签的补全。
• 使用 Jetpack Compose 与 Salt UI，支持 Material 3 动态取色、主题模式、启动页、触觉反馈等自定义选项。
• 多语言支持，目前提供简体中文、英语、韩语。
• 界面干净无广告，只在获取在线歌单、检查更新等必要操作时连接互联网。

安装与使用

推荐 Android 12（API 31）及以上版本，兼容 Android 8.0（API 26）及以上版本。

1. 从项目 Release 下载最新版本的 app-release.apk 并安装。
2. 无 Root 权限时可选择：在 App 内登录音乐平台账号在线获取歌单；或安装修补后的音乐平台 App；或使用虚拟机提供的 Root 权限获取数据库文件。已有 Root 权限的用户可在设置中开启“使用 Root 权限”。
3. 若使用数据库方式，先在在线音乐平台客户端依次打开需要导出的歌单并滑动到底部，加载全部歌曲，再关闭客户端；随后获取对应的数据库文件。
4. 打开歌单无界，在“设置”中按需调整动态取色、主题模式、启动页、语言、触感反馈、启动时检查更新等选项。
5. 在“扫描”页选择音乐文件所在目录，扫描设备中的歌曲。若需在其他设备转换，可开启“导出结果”并选择 .db 或 .txt 格式。
6. 在“转换”页选择“流媒体 → 本地”，选择歌单来源平台和歌单获取方式，完成转换后导入本地音乐播放器。

使用过程中可能还需要配合在线音乐平台的 Android 客户端、音乐标签、文件管理器、虚拟机或修补工具，以及目标本地音乐播放器。

注意事项

• 刷新本地音乐标签信息会覆盖已有标签，请谨慎操作；若已自行匹配或修改过标签，可跳过该步骤。
• Android 11 及以上需要“所有文件管理权限”，用于读取音乐文件并写入结果文件；Android 10 及以下需要读外置存储和写外置存储权限。
• Spotify 中音乐的标题大多使用英语、繁体中文或原语言，匹配准确率可能有所降低。
• 无 Root 权限且未安装修补后的音乐平台 App 时，部分平台通过在线方式获取歌曲数量可能受限；歌单歌曲较多时，README 推荐使用修补应用等方式。
• 调用 UM Project 可执行文件的功能仅供开发者学习研究使用，出于法律法规等因素考虑，不会公开提供此功能。
• 项目采用 MIT 许可证。

本作品整理自 GitHub 开源项目 Winnie0408/LocalMusicHelper，原作者 @Winnie0408，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。