spotDL 完整教程3 条命令把 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 是一个免费开源的命令行工具它会自动在 YouTube 等平台上找到你 Spotify 歌曲或歌单的对应音源并把音频、专辑封面、歌词和元数据一次性下载到本地让你把整个歌单变成真正属于自己的音乐库。 为什么值得用 spotDL一个链接搞定一切粘贴 Spotify 歌曲、专辑、艺人或歌单链接找歌、下载、填封面、写元数据全自动。元数据开箱即用下载完的文件自带标题、艺人、专辑名和封面扔进任何音乐播放器都能正常显示。匹配准确内置相似度算法会自动过滤 live、cover、remix、slowed 等版本减少下错歌。音源可切换支持 YouTube、YouTube Music、SoundCloud、Bandcamp 等多个音频源可配置多个作为后备。不止命令行内置 Web 界面不习惯敲命令的人也能在浏览器里搜索下载。 三步快速上手第一步环境准备Python 3.10 ~ 3.14Windows 安装时记得勾选 Add to PATHFFmpeg 4.2 或更高版本下一步可以让 spotDL 自己下载不用手动装无需显卡普通电脑、NAS、服务器都能跑第二步安装打开终端运行pip install spotdlmacOS / Linux 若提示找不到命令换成pip3运行spotdl --download-ffmpeg让 spotDL 把 FFmpeg 装到自己的工作目录运行spotdl --download-deno安装 Deno强烈建议缺了它部分 YouTube 视频会下载失败不想用 pip 的话也可以克隆源码构建git clone https://gitcode.com/GitHub_Trending/sp/spotify-downloader进入目录后执行pip install uv、uv sync、uv run scripts/build.py可执行文件会生成在dist/里。第三步首次运行先cd到你希望存放歌曲的目录文件会下载到当前目录然后spotdl download https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b几分钟后当前目录里就会出现一首带封面、带标签的 MP3。恭喜你已经会用 spotDL 了。 功能巡礼按输入方式分组粘贴 Spotify 链接最常用的方式歌曲、专辑、艺人、歌单链接都直接支持同一行可以用空格堆叠多个任务排队下载spotdl download https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID spotdl download The Weeknd - Blinding Lights https://open.spotify.com/album/4yP0hdKOZPNshxUOjY0cZj文字搜索下载没有链接也没关系直接用引号包一个搜索词spotdl download The Weeknd - Blinding Lights想搜专辑、歌单、艺人时加上前缀结果会更准album:专辑名、playlist:歌单名、artist:艺人名。下载你账号里的收藏需登录加上--user-auth完成一次 OAuth 登录后就能批量拿自己的数据spotdl download saved --user-auth # 所有红心歌曲 spotdl download all-user-playlists --user-auth # 我创建的全部歌单 spotdl download all-user-saved-albums --user-auth # 我收藏的全部专辑手动指定音源YouTube 链接 Spotify 元数据自动匹配偶尔失手时你可以手动指定音频用这个 YouTube 视频元数据用这首 Spotify 歌两个链接用|连接spotdl download https://www.youtube.com/watch?vXXYlFuWEuKI|https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b浏览器操作Web 界面运行spotdl web后打开http://localhost:8800即可在网页里搜索歌曲、查看下载列表和进度界面源码在 spotdl/web/目前主要面向单曲下载批量任务还是命令行更顺手。歌单同步让本地库跟着线上歌单走# 首次生成同步文件文件名必须以 .spotdl 结尾 spotdl sync https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID --save-file the-weeknd.sync.spotdl # 之后随时执行新歌自动下载、被删的歌自动移除 spotdl sync the-weeknd.sync.spotdl加上--sync-without-deleting可以只补新不删除。先存元数据以后再下载spotdl save [query] --save-file my-list.spotdl --preload--preload会提前解析好下载链接之后正式下载时速度明显更快。 实战场景场景一把 300 首歌的歌单一次性搬进本地播放器需求换了一款支持本地曲库的播放器想把整个歌单连同封面迁过去。解决方案一条命令下载歌单同时生成 m3u 播放列表方便播放器导入spotdl download https://open.spotify.com/playlist/XXXX --threads 8 --m3u关键参数--threads 8提高并行下载速度--m3u自动生成播放列表文件默认 MP3 格式兼容性最好。场景二本地收藏长期跟 Spotify 保持同步需求每周往歌单加新单曲希望电脑里的曲库自动跟上。解决方案用sync操作首次生成.spotdl同步文件之后定期手动或定时任务执行一次即可。关键参数同步文件路径--save-file my.sync.spotdl不想删歌时加--sync-without-deleting。场景三用 YouTube Music Premium 拿到 256kbps 高音质需求默认 128kbps 不够听想用 Premium 账号的 256kbps 源。解决方案在 YouTube Music 设置里把音质调到最高 → 用浏览器插件导出cookies.txt→ 下载时带上 cookie 文件并跳过转码。spotdl download [query] --cookie-file cookies.txt --format m4a --bitrate disable关键参数--format m4a或opus--bitrate disable保留原始高码率文件避免二次压缩。️ 调优与排错下载速度--threads调整并行线程数默认 4宽带环境可调到 8长歌单先用save --preload预解析链接正式下载会快一截音频质量普通账号上限 128kbps有 YouTube Music Premium 时走上面场景三的方案可到 256kbps--format支持 mp3 / flac / ogg / opus / m4a / wav--bitrate可指定码率或设disable不转码匹配与常见报错下错歌或漏歌加--only-verified-results只取高可信结果或临时--dont-filter-results看看原始匹配spotdl is not recognizedPython 没加进 PATH重装时勾选 Add to PATHYT-DLP download error基本是缺 Deno运行spotdl --download-denoHTTP Error 404、RecursionError之类先升级pip install -U spotdl更多问题参考官方 docs/troubleshooting.md完整参数说明见 docs/usage.md 速查表常用命令你想做什么命令下载单曲/专辑/歌单spotdl download [spotify链接]文字搜索下载spotdl download 歌名 - 歌手下载红心歌曲spotdl download saved --user-auth启动 Web 界面spotdl web默认端口 8800歌单同步spotdl sync [同步文件.spotdl]只存元数据spotdl save [query] --save-file x.spotdl查看全部选项spotdl -h高频参数参数作用示例值--format输出格式mp3、m4a、flac--bitrate输出码率128k、disable--threads并行线程数8--output文件命名模板{artists} - {title}.{output-ext}--m3u生成播放列表my-playlist.m3u--audio指定音频源youtube、soundcloud--cookie-filePremium 高音质 cookiecookies.txt文件位置配置文件Windows 在C:\Users\用户\.spotdl\config.jsonLinux 在~/.config/spotdl/config.json运行spotdl --generate-config可重新生成下载文件始终保存在你运行命令时的当前目录默认输出命名{artists} - {title}.{output-ext}可用--output改音频源与歌词源的源码分别在 spotdl/providers/audio/ 和 spotdl/providers/lyrics/想换源可以从这里入手写在最后从第一条spotdl download开始到你的整个 Spotify 收藏变成离线可用的本地音乐库中间只有几行命令的距离。挑一个最近想听歌单试一次再慢慢加同步、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），仅供参考