spotdl共享歌单批量下载

简介

spotDL 是一个用 Python 写的开源命令行工具，专门处理「想把 Spotify 上的整份歌单存到本地、却只能一首一首手动另存」的问题。给它一条歌曲、专辑或歌单链接，它会到 YouTube、YouTube Music 等音频源找到对应音轨，下载为 MP3 等格式存进本地文件夹，并把专辑封面、歌词和 ID3 元数据一并嵌入文件。它适合习惯命令行、需要批量整理曲库的个人用户，以及自建本地媒体库的爱好者；在 Windows、macOS、Linux 上都能使用，一条链接处理整份列表、输出信息完整，是它相对手动逐首保存最明显的优势。

核心功能

• 接受 Spotify 歌曲、专辑与歌单链接作为输入，一条链接即可批量处理整份列表，不必逐首操作。
• 在 YouTube、YouTube Music 等音频源自动匹配对应音轨，把 Spotify 的曲目信息与外部音频资源对应起来。
• 下载为 MP3 等本地音频文件，保存到指定文件夹，便于离线播放与归档。
• 自动写入 ID3 元数据，包含曲目名称、专辑封面、流派等来自 Spotify 的字段。
• 一并嵌入歌词与专辑封面，本地播放器可以直接显示曲目信息。
• 以命令行方式运行，可以写进脚本做批量或定时处理。
• 提供多条部署路径：Python 环境、预编译可执行文件、Docker / Docker Compose、Termux。

使用场景

• 把别人分享的整份共享歌单一次性存到本地，在通勤、飞行等无网络环境下播放。
• 自建本地音乐库或媒体服务器，需要统一的封面、歌词与元数据，避免文件名混乱。
• 批量整理已有收藏，把散落的单曲按专辑或流派重新归档到本地文件夹。
• 在 NAS、服务器或容器环境里用 Docker 部署，长期处理多份歌单。
• 在 Android 设备的 Termux 环境中直接运行，不必依赖桌面电脑。

安装与获取步骤

1. 先确认基础运行环境：Python 3.6.1 或更高版本并已加入 PATH；Windows 用户按官方说明另装 Visual C++ Redistributable。
2. 准备 FFmpeg 等运行时依赖，部分部署方案还会用到 Deno，完整清单见官方安装文档 docs/installation.md。
3. 按系统选择获取方式：通过 Python 包管理器安装（官方推荐路径）、下载预编译可执行文件、使用 Docker / Docker Compose，或在 Termux 中部署。
4. 按所选方式完成首次运行验证，确认命令能正常响应后再开始批量处理。
5. 复制 Spotify 中的歌曲或歌单链接作为输入执行下载，产物保存到本地文件夹，之后可抽查试听确认匹配结果。
6. 相关页面：https://spotdl.github.io/spotify-downloader/installation/ 、https://github.com/spotDL/spotify-downloader 、https://pypi.org/project/spotdl/

与同类方案的区别

• 与网页端逐首保存相比：spotDL 用一条链接处理整份歌单，产物统一落在同一个文件夹里。
• 与只抓取音频流的下载器相比：它把 Spotify 的元数据、封面与歌词一起写入文件，本地播放器识别更完整。
• 与手动在 YouTube 搜索下载相比：匹配过程是自动的，但音频来源仍是 YouTube，匹配结果并非 100% 准确。

注意事项

• 匹配结果来自 YouTube，存在错配：有用户统计约 0.5% 的曲目会匹配到错误音频，两万首歌约一百首，批量完成后建议抽查试听。
• 部分曲目可能在音频源中找不到对应内容，此时不会生成本地文件，需要单独处理。
• 音频源的可用性受网络与地区影响，某些曲目可能取不到，具体表现以官方页面为准。
• Python 需要加入 PATH，否则终端无法识别命令；FFmpeg 属于必需运行时，未就绪时相关处理无法完成。
• 下载内容的使用应遵守当地法律法规与平台条款，仅用于个人合法用途。
• 输出格式、元数据字段与各部署方案的细节以官方页面为准：https://spotdl.net/