Playlist Out · 把你的歌单带走

你的歌单，不应该只困在一个音乐平台里。

解析、导出，并把歌单继续带进支持的开源播放器。

🌐 在线网页版：打开浏览器即可直接使用 👉 playlistout.lengxiqwq.com

💡 想要直观了解如何使用？点击下方封面观看官方宣传与功能演示视频：

🍿 观看视频：别让歌单被平台困住！Playlist Out - 开源跨平台歌单导出神器

💡 注：WinGet (winget install LengxiQwQ.PlaylistOut) 与 Scoop 官方源正在同步审核中。

💡 说明：双击免安装单文件或终端输入 playlistout 即可进入交互式向导（如下图）；亦支持纯命令行参数调用与自动化脚本（详见文末常用命令）。

详细字段和格式定义见 导出格式说明 和 JSON Schema。

Playlist Out 不只帮你把歌单导出来，也能把它继续带进你喜爱的开源音乐播放器。

在 MusicFree 中安装 Playlist Out 插件后，即可在播放器中通过「导入外部歌单」直接粘贴歌单链接或导入导出的 JSON 文件：

• 插件安装链接（复制下方链接到 MusicFree「插件设置 → 从网络安装插件」中粘贴即可安装）：

https://playlistout.lengxiqwq.com/plugins/musicfree/把你的歌单带走-PlaylistOut.js

• 使用指南：MusicFree 插件安装与使用说明 · MusicFree 官网

BBPlayer 已完成 Playlist Out 歌单导入适配，将在下一正式版本中原生内置，届时无需安装任何插件，直接粘贴链接即可导入。

• BBPlayer 官网 · GitHub 仓库

• 更多播放器适配计划：我们规划了针对 LX Music、Listen 1 等开源播放器的本地歌单导入适配方案，欢迎社区共同推进。

Playlist Out CLI 支持交互向导与命令行参数两种模式，常用调用示例如下：

# 1. 交互向导模式（直接回车，根据屏幕提示粘贴链接即可）
playlistout

# 2. 单歌单直接导出（可多选格式：xlsx, csv, json, txt, m3u8）
playlistout "https://music.163.com/playlist?id=2756674066" -f xlsx,csv

# 3. 纯数字 ID 解析（通过 -p 锁定平台）
playlistout "9044196528" -p qqmusic -f xlsx

# 4. 用户公开歌单批量导出（支持全量导出或指定编号）
playlistout "1160951354" -p qqmusic --user -f json --no-open
playlistout -p kugou --user --select 1,2 -f json --no-open

# 5. 酷狗凭证配置（亦可直接输入 login 调出终端扫码）
playlistout -p kugou --token <TOKEN> --userid <USERID>

👉 更多参数选项、平台特性与退出状态码详见 Playlist Out CLI 使用指南。

Playlist Out 提供 Public API 和统一的 Canonical JSON 数据格式，可用于播放器、插件、迁移工具和自动化脚本。

无需注册账号或申请 Token，可以直接调用：

curl "https://playlistout-api.lengxiqwq.com/api/v1/resolve?q=https://music.163.com/playlist?id=2756674066"

支持长链接、短链和分享文本自动识别，多平台返回统一的数据结构，并允许浏览器跨域调用。

公共端点单 IP 限制为每分钟最多 6 次请求。

👉 Public API 完整文档

Playlist Out 导出的 JSON 使用统一数据结构。第三方播放器或工具只需适配一套 Schema，即可读取来自不同音乐平台的歌单。

👉 JSON 数据格式定义

Playlist Out 为第三方播放器、插件和音乐工具提供统一的歌单接入能力：

• 通过 Public API 直接解析歌单链接、短链和分享文本。
• 读取 Playlist Out Canonical JSON，在本地完成歌单导入和数据转换。
• 根据目标应用的数据结构进行字段映射，并接入现有导入流程。
• 新的播放器、插件或工具适配可以通过 Issue 讨论接入方案和兼容需求。

详细的接入方式、字段映射和适配计划见：

👉 开源播放器生态接入与适配计划

仓库使用 monorepo 管理 Web、Worker、CLI 和插件：

playlistout/
├── web/                  # React / Vite 网页前端
├── worker/               # Cloudflare Worker API
├── cli/                  # Python CLI
├── plugins/              # 开源播放器插件
├── docs/                 # API、协议与项目文档
└── scripts/              # CI、构建与发布脚本

常用命令：

# 安装依赖
npm install

# 启动本地开发环境
npm run dev

# 运行完整检查
npm run check

# 构建 Web / Worker / 插件
npm run build

# 从源码运行 CLI
python -m pip install -r cli/requirements.txt
python -m cli

# 构建当前系统的 CLI 发行包
python -m pip install -r cli/requirements-release.txt
python scripts/release/build-cli.py

# 本地一键归集发行文件
npm run build:publish

Windows、Linux、macOS Apple Silicon 和 macOS Intel 的完整发行包由 GitHub Actions 自动构建。

推送版本 Tag 后，Release CLI Workflow 会在对应系统的 GitHub Runner 上完成构建、测试、校验文件生成和 Draft Release 创建。

更完整的构建与发布流程见 CLI 维护者发布手册，Web、Worker 和生产环境部署见 部署与运维说明。

Issue、功能建议和 Pull Request 都欢迎。

如果你希望接入新的音乐平台、适配新的播放器或修复兼容问题，可以直接创建 Issue。

👉 提交 Issue

Playlist Out 使用 MIT License 开源。

你可以在保留原始版权与许可声明的前提下自由使用、复制、修改和分发代码，包括用于商业项目。

📊 仓库流量

访问次数：2,711 ｜ 不重复访客：391（近 14 天） ｜ 仓库克隆：11,753 ｜ 不重复克隆：152（近 14 天）

热门来源（近 14 天）： Google · github.com · Bing · Baidu · audio-file.org · kaiyuanbang.cn
热门内容（近 14 天）： releases/tag/v3.0.0 · plugins/musicfree/README.md · docs/JSON-SCHEMA.md · README.md

数据开始：2026-09-07 · 最后更新：2026-11-11