spotDL 上手笔记5 分钟跑通 Spotify 歌单下载【免费下载链接】spotify-downloaderDownload your Spotify playlists and songs along with album art and metadata (from YouTube if a match is found).项目地址: https://gitcode.com/GitHub_Trending/sp/spotify-downloaderspotDL 是一个从 Spotify 下载音乐的命令行工具。它的思路很直接用 Spotify 链接或搜索词当线索自动到 YouTube 上匹配对应音频把下载下来的 MP3 连同专辑封面、歌词、元数据一起整理好。适合想把歌单用到线下、或者想维护本地曲库的人。读完这篇你能把一个歌单链接变成一条命令拿回一份带封面和标签的本地曲库。 四步装好 spotDL下出第一首歌第 1 步准备环境。需要 Python 3.10 到 3.14运行python -V确认。如果没装从官方渠道安装并在安装时勾选 “Add to PATH”。做完后应看到python -V打印出 3.10 到 3.14 之间的版本号。第 2 步安装 spotDL。打开终端Windows 用 Command PromptmacOS 用 Terminal运行pip install spotdlmacOS 和 Linux 上把pip换成pip3。做完后应看到运行spotdl --version能打印出版本号说明命令已被识别。第 3 步安装 FFmpeg。spotDL 靠 FFmpeg 转码和写元数据。推荐先运行spotdl --download-ffmpeg它会把 FFmpeg 直接装进 spotDL 安装目录不污染系统环境也可以系统级安装brew install ffmpeg或sudo apt install ffmpeg。做完后应看到转换、封面、标签环节不再报 FFmpeg 缺失。第 4 步建议安装 Deno。部分 YouTube 视频包括 “made for kids” 类视频需要 Deno 才能下载运行spotdl --download-deno做完后应看到这类视频不再抛YT-DLP download error。首次出结果spotDL 把文件存到你运行命令时所在的目录所以先cd到想存放的目录再执行spotdl download https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b稍等片刻该目录里会出现一个以歌手 - 歌名.mp3命名的文件用任意播放器打开标题、艺术家、封面都已填好——这就是你的第一次产出。 从单曲到全曲库三层使用流程基础能力链接或关键词下什么都行。输入是一首歌、专辑、歌单或艺术家的 Spotify 链接也可以是加引号的搜索词例如spotdl download The Weeknd - Blinding Lights输出是一批带元数据和封面的 MP3多个链接可以空格拼接在同一条命令里排队下载适用场景是把已有的歌单搬成本地或随手收藏一首单曲。不想碰终端的话运行spotdl web会在http://localhost:8800打开浏览器界面web 端功能比命令行少主要支持单曲下载。如果暂时不想下载spotdl save [query] --save-file name.spotdl只把元数据存进.spotdl文件以后随时再用。进阶能力让本地曲库跟着歌单走。输入是一个歌单链接先运行spotdl sync [歌单URL] --save-file the-weeknd.sync.spotdl文件名必须以.spotdl结尾建立基准输出是一份记录当前曲库状态的同步文件此后运行spotdl sync the-weeknd.sync.spotdl新加入的歌会被下载被移出歌单的会被删除加上--sync-without-deleting则只增不删适用场景是每周更新、需要长期维护的常听歌单。已经下过但标签被改坏的文件用spotdl meta重写元数据只想查每首歌的音频来源时用spotdl url打印来源地址。高级玩法把整个账号当下载对象。输入是登录后的 Spotify 账号命令加--user-authspotdl download saved --user-auth下完全部点赞歌曲all-user-playlists、all-user-saved-albums同理覆盖歌单和专辑输出是完整的离线曲库适用场景是把账号的听歌历史整体迁到本地。自动匹配失败时可以用spotdl download YouTubeURL|SpotifyURL手动指定音源让 spotDL 用你给的 YouTube 音频配上 Spotify 的元数据。⚙️ 先选配置再动手快速测试与正式产出两套spotDL 会自动读取配置文件位置在~/.config/spotdl/config.jsonWindows 为C:\Users\user\.spotdl\config.json运行spotdl --generate-config可以立即生成一份。核心参数如下参数默认值推荐值调整影响--formatmp3mp3求兼容/m4aYTM 会员决定文件兼容范围m4a 和 opus 才能承载更高码率的原始文件--bitrate128k普通用户128k会员disable调高只会增大体积音源上限 128k会员可达 256k--threads44–8并行下载速度过大受网络限制--audioyoutube-musicyoutube-music youtube多个音源按顺序兜底减少缺歌--lyricsgenius等三个源保持默认歌词来源的查找顺序前一个失败才轮到下一个--overwriteskipskip已有文件的处理方式metadata只补写标签output{artists} - {title}.{output-ext}保持文件命名模板可插入{album}、{year}等变量--m3u不生成{list[0]}.m3u8额外生成 m3u 播放列表方便在播放器里整单播放两套现成配置可直接套用快速测试spotdl download 某首歌。用一首歌验证匹配和音质参数全保持默认。为什么这样设测试阶段只关心“匹配对不对、能不能播”默认参数引入的变量最少。正式产出spotdl download 歌单URL --audio youtube-music youtube --m3u --threads 8 --print-errors。为什么这样设大歌单用多个音源兜底减少缺歌--m3u生成播放列表方便整单听--print-errors在结束时汇总失败项方便一次性补漏。⚠️ 常见报错与降级方案按出现频率排序spotdl is not recognized/spotdl: command not foundPATH 没配好。Windows 重新安装 Python 并勾选 “Add to PATH”Linux 和 macOS 在~/.bashrc或~/.zshrc末尾加export PATH~/.local/bin:$PATH再执行source ~/.bashrc。AudioProviderError: YT-DLP download error缺 Deno运行spotdl --download-deno即可这类报错集中在部分视频上。pkg_resources.DistributionNotFoundyt-dlp 的依赖包不完整运行pip install brotli websockets yt-dlp -U补齐。KeyError: headerytmusicapi 版本过旧或 YouTube Music 接口波动。先pip install -U ytmusicapi若仍报错等几分钟重试官方说明该错误与 YouTube 的防爬机制有关以实际版本为准。资源不够时的降级思路磁盘紧张就先spotdl save只存元数据看清单再决定下哪些时间紧张就加--preload预解析下载地址或调低--threads质量不满意按这个顺序排查——先确认是不是匹配错了版本重跑一次并加--print-errors或试--only-verified-results再看格式与码率普通账号 128k 是正常上限有 YouTube Music Premium 时配--cookie-file cookies.txt加 m4a/opus 格式加--bitrate disable才能拿到 256k最后才是换音源在--audio里追加 provider 兜底。 下一步打开终端cd进打算存放曲库的目录运行spotdl download 一个搜索词用单曲验证匹配结果第一首听对了再指向你最常听的那个歌单顺手加上--m3u整单产出就齐了。【免费下载链接】spotify-downloaderDownload your Spotify playlists and songs along with album art and metadata (from YouTube if a match is found).项目地址: https://gitcode.com/GitHub_Trending/sp/spotify-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考