Sunnify：免费Spotify播放列表下载工具完整入门，无需账号一键下载整张歌单

Sunnify 是一款免费开源的Spotify 下载器（Spotify downloader），支持把 Spotify 播放列表、专辑和单曲批量下载为本地 MP3 / M4A / FLAC / Opus / WAV 文件，自动写入歌名、艺术家、专辑、年份和封面图。无需 Spotify 账号、无需 API Key、无需单独安装 FFmpeg，一个粘贴链接的动作就能下载整张歌单。下文将带你从零完成安装与首次下载。

🎵 Sunnify 是什么？

Sunnify 是一个跨平台桌面应用（macOS / Windows / Linux），基于 Python + PyQt6 构建，核心流程为：

1. 从 Spotify 公开页面读取歌曲元数据（无需登录）；
2. 通过 spotifydown_api.py 匹配真实音源，并按标题、艺术家、时长三重校验避免抓到 Remix；
3. 用内置的 FFmpeg 转码为你选择的格式，并把标签和封面写入每个文件。

每首歌都会单独存放封面，而不是共用一张歌单封面；所有下载并行进行，大歌单也能快速完成。

Sunnify 桌面客户端下载 Spotify 播放列表的操作界面

📦 三大平台安装方法

所有预构建版本都内置了 FFmpeg，下载即用。macOS 直接下载 zip 包首次打开时，可在"系统设置 → 隐私与安全性 → 仍要打开"中放行。

⚡ 快速上手：4 步下载整张歌单

1. 复制 Spotify 链接：在 Spotify 网页或 App 中右键歌单/专辑/单曲 → 分享 → 复制链接（spotify:URI 也支持）；
2. 粘贴到 Sunnify：把链接贴进顶部输入框；
3. 选择格式与质量：在 Settings 中挑选 MP3 / M4A / Opus / FLAC / WAV 和比特率（128–320 kbps），并指定保存目录（默认在音乐文件夹）；
4. 点击下载：实时查看每首歌的进度，随时可点 Stop 停止。

下载完成后，每个歌单或专辑会生成同名文件夹，文件按"歌曲名 - 艺术家"命名（可自定义），标签与封面已写好，直接拖进任何音乐库即可使用。

🎛️ 实用功能亮点

• 断点续传：每个文件夹内的.sunnify-manifest.jsonl会记录已下载歌曲，中途失败或被限流时重新运行即可续传，不必从头开始；
• 文件命名自定义：支持"歌曲 - 艺术家""艺术家 - 歌曲"或仅歌名三种风格，还可加01.这样的曲目序号前缀，让文件夹按歌单顺序排列；
• Unicode 安全：重音字符、中日韩、西里尔字母歌名都会完整保留；
• 精准音源匹配：按标题 + 艺术家 + 时长匹配，拿到的就是原版录音而不是加速版或 Remix。

💻 内置无头 CLI：一个应用，两种用法

每个 Sunnify 可执行文件同时也是命令行工具，同一引擎、同一份配置：

sunnify download "https://open.spotify.com/playlist/..." # 下载歌单/专辑/单曲 sunnify info "<url>" --json # 仅获取元数据 sunnify doctor # 环境自检

常用命令完整参考 docs/CLI.md，CLI 入口源码见 sunnify_cli.py。

🏗️ 从源码构建（可选）

如果你想在源码上跑起来，需要Python 3.10+和 FFmpeg：

git clone https://gitcode.com/gh_mirrors/su/sunnify-spotify-downloader cd sunnify-spotify-downloader pip install -r req.txt python Spotify_Downloader.py

桌面主入口为 Spotify_Downloader.py，UI 模板位于 Template.ui。

⚠️ 使用提醒

Sunnify 定位为教育 / 作品集展示项目，仅用于下载你拥有版权或已获授权的内容，请遵守所在地法律法规，详见 DISCLAIMER.md。各版本还提供 SHA256 校验和与构建溯源验证，方法见 SECURITY.md。

📚 参考资料

• 项目说明：README.md
• CLI 完整文档：docs/CLI.md
• Web 版前端与后端：web-app/
• 测试用例：tests/