Playlist Out（把你的歌单带走）

✦ 这是做什么的？#

Playlist Out 是一个面向歌单备份、导出与迁移的开源工具。

平时换音乐软件、备份歌单，或者想把几百上千首歌整理成表格时，最麻烦的不是音乐本身，而是歌单数据很难完整拿出来。Playlist Out 做的事情很直接：粘贴歌单链接、分享文本或用户主页，把歌单解析成统一的结构化数据，导成你自己能保存、整理的文件，或者直接带进受支持的开源音乐播放器。

它不是音乐播放器，也不下载、不存储任何音频文件。重点是把歌单里的歌曲名、歌手、专辑、封面、时长、VIP 专享与可用性状态完整整理出来：

如果你想用开源播放器听歌，可以通过独立插件、软件原生内置或标准 JSON 导入把歌单直接带过去；
如果你想整理个人曲库，可以导出清晰规范的 Excel / CSV 表格或 M3U8 播放列表；
如果你想迁移到 Apple Music、Spotify 等流媒体平台，也可以配合 Soundiiz / TuneMyMusic / FreeYourMusic 等工具直接导入。

✦ 支持的平台#

目前已全面支持几大主流音乐平台的歌单解析与导出：

平台	单歌单解析	用户歌单批量导出	说明与特性
网易云音乐	✅	✅	支持歌单链接、分享短链、歌单 ID，或输入用户 UID / 主页链接批量导出全部公开歌单
QQ 音乐	✅	✅	支持歌单链接、分享短链、歌单 ID，或输入 QQ 号 / 主页链接查询全部公开歌单并批量导出
酷狗音乐	⚠️ 免登录前 10 首	✅ 需登录	受官方限制，普通歌单免登录仅解析前 10 首；扫码登录或填入凭证后可完整导出并批量拉取个人云端歌单
酷狗概念版	✅	—	支持概念版集合歌单链接与分享短链，免登录全量解析无截断
酷我音乐	✅	—	支持歌单链接、分享短链、歌单 ID，全量多页自动合并获取完整歌单
汽水音乐	✅	—	支持分享链接、抖音口令、歌单 ID，可自由切换「汽水官方」与「抖音全量原声」双通道
咪咕音乐	✅	—	支持移动端短链 (`c.migu.cn`) 与网页链接，多页分页获取完整歌单

✦ 导出格式#

无论是网页版还是本地 CLI，均可在本地直接生成多种常用文件格式，无需上传任何数据到第三方服务器：

格式	文件扩展名	适合场景与特性
Excel	`.xlsx`	推荐：包含「歌曲列表 (Tracks)」与「歌单元数据 (Playlist Info)」双工作表，适合本地曲库整理与长期归档
JSON	`.json`	推荐：遵循 Playlist Out Canonical JSON 统一数据规范，适合第三方播放器、插件与脚本自动化解析
CSV	`.csv`	通用表格格式，适合跨平台迁移工具与数据分析导入
纯文本	`.txt`	极简歌曲清单（`歌名 - 歌手 - 专辑`），适合快速浏览、复制与文本分享
M3U8	`.m3u8`	标准 Extended M3U 播放列表格式，适合导入兼容该格式的本地播放器和流媒体库管理工具

✦ Playlist Out CLI 桌面版#

除了在线网页版，项目还提供了独立的本地命令行工具 Playlist Out CLI。在 3.0 版本中，它迎来了重要升级：

1. 独立运行与全生态安装#

无需配置 Python 与运行库：采用独立二进制打包，Windows 用户下载后直接双击 .exe 就能运行，macOS 与 Linux 也提供独立打包版本。
支持 npm 一键全局安装：
Terminal window
```
1
npm install -g playlistout
```
安装完成后，在终端直接输入 playlistout 即可随时启动。
WinGet / Scoop：官方源收录也在审核推进中。

2. 交互式向导与命令行参数双模式#

交互式向导模式（零门槛）：直接启动程序，会呈现像聊天一样的交互界面：把手机或电脑上复制的歌单链接、短链或分享文案直接粘贴进去，程序会自动识别平台，按提示回车即可完成导出，导完还会贴心地自动打开保存目录。
命令行参数模式（适合自动化与脚本批处理）：提供丰富的非交互参数，适合极客编写脚本批量执行：

1
# 解析单个歌单并导出指定格式
2
playlistout "https://music.163.com/playlist?id=2756674066" -f xlsx,json
3

4
# 批量导出 QQ 音乐用户的全部公开歌单（静默运行）
5
playlistout "1160951354" -p qqmusic --user -f json --no-open
6

7
# 批量导出网易云用户的指定歌单（例如第 1 和第 2 个歌单）
8
playlistout "1825474783" -p netease --user --select 1,2 -f json,csv --no-open
9

10
# 酷狗音乐：终端扫码登录或传入凭证持久化保存，解锁全量与个人云端歌单
11
playlistout -p kugou --token <TOKEN> --userid <USERID> --save-auth
12

13
# 汽水音乐：切换解析通道为抖音原声
14
playlistout "https://qishui.douyin.com/s/xxx" --channel douyin

✦ 把歌单带进开源播放器#

Playlist Out 不只帮你把歌单导出来，也能把它继续带进你喜爱的开源音乐播放器。
针对不同播放器的架构，项目提供了独立插件、软件原生内置以及通用 JSON 导入兼容等接入方式：

MusicFree（✅ 已支持 · 官方插件接入）#

在 MusicFree 中安装官方插件后，即可通过「导入外部歌单」直接粘贴歌单链接，或选择本地导出的 JSON 文件完成导入：

官方插件安装链接（复制下方链接到 MusicFree「插件设置 → 从网络安装插件」中粘贴即可安装）：
```
1
https://playlistout.lengxiqwq.com/plugins/musicfree/把你的歌单带走-PlaylistOut.js
```
纯解析与原生音源路由：解析出的曲目保留原平台自然归属，交由播放器本地安装的原生插件播放；
跨插件与内置兜底换源：在原平台音源缺失时，自动按「同名 + 同歌手 + 严格时长」跨插件寻找音源，并内置兜底音源引擎，宁可跳过绝不播错歌；
极简提示与静默开关：支持在插件设置中自由开关兜底引擎与播放弹窗提示，体验清爽无打扰。

BBPlayer（⏳ 即将上线 · 软件原生内置）#

BBPlayer 已在主程序中完成针对 Playlist Out 的原生歌单导入适配，无需额外安装任何插件，直接粘贴歌单链接在线解析或选择本地 JSON 文件即可秒级导入（将随 BBPlayer 新版本发布上线）。

应用	当前状态	规划接入方式
LX Music	💬 已向上游提案	本地 JSON 导入兼容
Listen 1	💬 已向上游提案	本地 JSON 导入兼容
Moosync	🗓️ 计划中	Extension 扩展适配

✦ 开放 API 与标准数据协议#

Playlist Out 坚持完全开放的开发者生态，提供现代化的边缘 API 与标准数据格式：

Public API：基于 Cloudflare Workers 构建，全球边缘节点就近调度。
- 提供智能解析端点（GET /api/v1/resolve?q=...），长短链与分享文本自适应识别；
- 提供单歌单端点（/api/v1/playlist）与用户公开歌单批量端点（/api/v1/user/playlists）；
- 全面开放 CORS 跨域请求，无需注册账号或申请 Token，前端 Web、插件与桌面脚本可直接调用。
Canonical JSON 数据协议：统一标准化 Track 与 Playlist 数据结构，规范各平台的歌曲状态标定（正常、VIP 专享、下架/无版权等）与字段命名。第三方工具只需适配一套规范，即可消费多个平台的歌单数据。

✦ 为什么会有这个项目？#

最开始它只是我为了导出 QQ 音乐歌单写的一个 Python 小脚本。

后来发现“歌单被困在某个平台里”并不只是某一家音乐平台的问题，所以才慢慢把它做成网页版，并一步步补齐各大音乐平台、用户批量导出、Playlist Out CLI 桌面版、开放 API，以及开源播放器生态的深度互通。

做 Playlist Out 的初心其实一直没变：让歌单属于用户自己，先把歌单数据完整拿出来，再继续带到你真正想去的地方。

音乐

音乐