spotDL 下载 Spotify:4 条命令把整张专辑搬进本地【免费下载链接】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地铁里断了信号,Spotify 的歌单全灰。用 spotDL 下载 Spotify 歌曲,这个问题一条命令就能解决:它去 YouTube 上找对应音频,把歌曲连同封面、歌词、元数据一起存到本地,断网照样播。极速上手:安装 spotDL 并下第一首歌读完这节,你能装好工具并看到第一首下载成功的歌。先确认本机有 Python 3.10 及以上(安装时勾上 Add to PATH)。然后在终端执行:pip install spotdl spotdl --download-ffmpeg # 把 FFmpeg 装到 spotdl 目录,无需配置系统 spotdl --download-deno # 强烈建议装,否则部分歌曲会下载失败⚠️ FFmpeg 是硬依赖,第一条命令装完 spotdl 后务必跟着跑第二条。装好后,在任意目录执行:spotdl download The Weeknd - Blinding Lights预期输出:当前目录多出一个The Weeknd - Blinding Lights.mp3,自带封面和内嵌 ID3 标签。至此你已经会 spotDL 下载 Spotify 的主流程了;如果你不想装 Python,文末附录里有一行 Docker 命令。核心场景:三种方式把歌弄到本地读完这节,你会按整张专辑、Web 界面、歌单同步三种真实需求操作。把整张专辑入库spotdl download https://open.spotify.com/album/4yP0hdKOZPNshxUOjY0cZj预期输出:专辑里每首曲依次下载,文件名自动带上曲目序号和年份。把 URL 换成你自己的专辑或歌手主页链接即可,命令完全一样。用 Web 界面点歌下载spotdl web浏览器打开 localhost:8800,在搜索框输入歌名,点搜索后点下载图标即可。注意 Web 界面目前只支持单曲下载,歌单和专辑还是走命令行。把歌单同步到本地第一次运行,下载整份歌单并生成快照文件:# 首次:下载歌单 生成快照 spotdl sync https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID --save-file my-list.sync.spotdl # 以后:歌单有变动时只跑这一条 spotdl sync my-list.sync.spotdl预期输出:新增的歌被补下载,被移出歌单的歌从本地删除,其余文件不动。不想删歌就在后面加--sync-without-deleting。进阶调优:3 个真正有用的开关读完这节,你能改文件命名、提升音质、固化默认配置。改文件名规则默认:文件名是艺术家 - 歌名.mp3,落在你执行命令的目录你想改:按专辑、年份归档,方便建文件夹一条命令:spotdl download URL --output {artists} - {title} ({year}).{output-ext}可用变量还有{album}、{track-number}、{list-name}等,完整列表见 docs/usage.md。拿 256k 的高音质默认:从 YouTube 抓 128k MP3;转成 320k 只会变大,不会更清晰你想改:有 YouTube Music Premium 账号,拿真正的 256k一条命令:spotdl download URL --cookie-file cookies.txt --format m4a --bitrate disablecookies.txt 从 music.youtube.com 导出,--bitrate disable表示跳过转码、保留原始质量。固化默认配置默认:选项只对当前命令生效你想改:一次设置,以后不用重复敲一条命令:spotdl --generate-config(会覆盖已有配置,先备份)生成的配置文件在 Windows 的C:\Users\用户名\.spotdl\config.json,Linux/macOS 在~/.config/spotdl/config.json,改里面的 bitrate、format、歌词源即可。避坑速查读完这节,你能秒解新手期最常卡的 3 个问题。spotdl is not recognizedPython 安装目录没进 PATH。重装 Python 并勾选 Add to PATH,或 Linux 下把~/.local/bin加入 PATH,然后重开终端。文件不在你以为的目录spotDL 下载到你执行命令时所在的文件夹。跑之前先cd进音乐目录;Windows 可以 Shift 右键文件夹,选在此处打开终端。部分歌曲报 YT-DLP download error多数是缺 Deno,yt-dlp 拉取部分视频依赖它。执行spotdl --download-deno修复;更细的排查看 docs/troubleshooting.md。现在再进地铁,点开歌单照样出声——整库已经在你本地目录里了。附录Docker 一行起:docker run --rm -v $(pwd):/music spotdl/spotify-downloader download track URL;需要权限管理可用仓库自带docker-compose.yml生成配置模板:spotdl --generate-config配置文件:WindowsC:\Users\用户名\.spotdl\config.json;Linux~/.config/spotdl/config.json文档:docs/usage.md · docs/installation.md · docs/troubleshooting.md社区:官方 Discord(自行搜索 spotDL Discord)【免费下载链接】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），仅供参考