把 Spotify 歌单搬进本地硬盘，只靠一个命令：spotify-downloader 保姆级上手

把 Spotify 歌单搬进本地硬盘只靠一个命令spotify-downloader 保姆级上手【免费下载链接】spotify-downloaderDownload your Spotify playlists and songs along with album art and metadata (from YouTube if a match is found).项目地址: https://gitcode.com/gh_mirrors/spotifydownlo/spotify-downloader先想一个问题你的 Spotify 歌单真的属于你吗spotify-downloader是一个开源命令行工具专治这个心病——它能把 Spotify 上的单曲、专辑和整张歌单转成本地 MP3连同封面、歌词和完整元数据一起留下。能从中受益的正是那些曾在信号盲区或订阅断档时对着灰色歌单干瞪眼的人。比如一个月前的我。那个周末我带着攒了半年的露营歌单进山信号一格不剩100 多首歌瞬间变成一堆无法点亮的灰色条目。后来才知道订阅一旦停掉这些歌单会被回收——你收藏了它们却从没真正拥有过它们。先看结果三个它替你干完的活在折腾具体命令之前先说我在实测中最满意的三点一个链接换一首 MP3把 Spotify 的歌曲链接丢给它剩下的事它全包了元数据不是半成品下载完的文件自带专辑封面和内嵌歌词连发行日期、碟号、ISRC 编码这些细节都有扔进任何播放器都像正规渠道买的不用申请任何 API Key很多同类工具第一步就劝退人——去开发者后台注册、填表、等审批。它把凭证内置好了装完就能用。一句话总结输入是 Spotify 链接输出是带完整信息的本地音频文件。它的工作机制一个找货 送货的中间人它为什么能做到原理不神秘总共四步用 Spotify 接口拿到歌曲的完整信息歌名、艺术家、专辑、时长用这些信息去 YouTube 上搜索匹配的音频下载后用 FFmpeg 转成指定格式默认 MP3把第一步拿到的元数据写进文件顺手嵌入封面和歌词。类比一下Spotify 负责告诉你这是谁的哪首歌YouTube 负责提供音频本身spotify-downloader 是那个来回跑腿、还顺手把包装做精美的中间人。整个匹配过程可以全自动也可以在你监督下手动确认后面会讲到具体参数。三行命令完成安装前提系统里有 Python 3.6 或更高版本。然后按顺序执行pip3 install githttps://gitcode.com/gh_mirrors/spotifydownlo/spotify-downloader.git这条命令把工具装进你的 Python 环境。# Ubuntu / Debian 用户 sudo apt-get install ffmpeg # macOS 用户 brew install ffmpegFFmpeg 负责音频转码和元数据写入是核心依赖别跳过这一步。spotdl --help看到一屏参数说明就说明安装成功了。第一次实战两分钟下载第一首歌先挑最简单的场景——单曲下载。两种方式任选spotdl --song https://open.spotify.com/track/歌曲ID直接丢 Spotify 链接适合你明确知道要下哪首的时候。spotdl --song 周杰伦 - 七里香没有链接直接输入歌手 - 歌名它也能搜。实测感受命令行会实时打印匹配到的 YouTube 视频信息下载、转码、写元数据一气呵成。对一首 4 分钟的歌来说全程通常不到两分钟。我第一次跑通时盯着终端里跳出的进度条还真有点成就感。批量下载歌单先导出清单再统一收割歌单的处理方式和单曲不同要分两步走spotdl --playlist https://open.spotify.com/playlist/歌单ID第一步它把歌单里的每首歌解析出来写进一个文本文件比如歌单名.txt方便你事后检查、增删。spotdl --list 歌单名.txt第二步把这个文本文件交给它批量下载它按顺序一首一首处理。这个设计的巧妙之处在于清单文件是纯文本你可以手动删掉不想要的歌、调整顺序甚至把多个歌单合并到一个文件里再一起下。我实测过一个 62 首歌的歌单中途断网重跑了一次已经落盘的文件会被识别并跳过剩下没下载的接着补不用从头再来。歌单越长这一点越救命。让音乐库长出你自己的目录结构默认情况下下载的文件叫艺术家 - 歌名.mp3平铺在一个文件夹里。想按自己的习惯组织用-f参数指定模板spotdl --song 周杰伦 - 七里香 -f {artist}/{album}/{track-number} {track-name}.{output-ext}这条命令会把文件放进艺术家/专辑/序号 歌名.mp3的层级里专辑目录会自动创建。支持的占位符还有{year}、{genre}、{disc-number}等足够拼出任何你想要的命名规则。输出格式和音质同样可调spotdl --song 周杰伦 - 七里香 --output-ext flac --quality best--output-ext支持 mp3、m4a、flac、ogg、opus 五种--quality决定在 YouTube 侧优先挑最佳音源还是最差音源。匹配不准的时候还有两个手动武器自动匹配偶尔会翻车——歌手有多个同名版本、官方版本没上传都是常见情况。这时有两个补救手段spotdl --song 某首歌 --manual--manual会把所有候选结果列出来并编号让你亲自挑最合适的那一个而不是让程序自作主张。spotdl --song 某首歌 --search-format {artist} - {track-name} nightcore--search-format用来重写 YouTube 搜索关键词。我试过用它专门找某一类版本比如在搜索格式里加上 nightcore 后缀下载到的就是加速版。类似的技巧可以举一反三加 live 找现场版加 remastered 找重制版。把常用参数焊死成配置文件如果你经常用同一组参数每次都敲一遍很累。工具第一次运行时会生成一个config.yml配置文件编辑一次即可spotify-downloader: output_ext: mp3 output_file: {artist}/{album}/{track-name}.{output-ext} quality: best overwrite: skip把常用默认值写进去之后的命令就能省略这些参数。注意命令行参数永远优先于配置文件——临时想覆盖某个设置直接在命令里加上即可不必反复改文件。完整的参数清单可以查阅项目文档里的docs/source/available-options.rst。使用前必须知道的事关于版权写到这里有一句话必须放在前面这个工具主要用于学习和备份你自己拥有使用权的音乐。下载受版权保护的音乐在部分国家或地区是违法的。请先了解你所在地的法律并尽量支持正版——如果你真的喜欢某位歌手买一张专辑比下载一百首更有分量。现在轮到你动手了这篇文章里的每一步我都亲自跑过从安装到批量下载大约花了一个下午。但工具的价值不在于我帮你试过了而在于你自己跑一遍。所以留给你一个 15 分钟的小挑战找一首最近单曲循环的歌先跑通安装和单曲下载再用-f把它放进歌手/专辑的目录结构里。跑通了就去处理你的第一个歌单。最后留个问题给你你会先备份哪个歌单是跑步专用还是深夜 emo 专用想好答案打开终端开始动手。【免费下载链接】spotify-downloaderDownload your Spotify playlists and songs along with album art and metadata (from YouTube if a match is found).项目地址: https://gitcode.com/gh_mirrors/spotifydownlo/spotify-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考