如何快速安装Sunnify:macOS/Windows/Linux三平台Spotify下载器一条命令部署指南
如何快速安装Sunnify:macOS/Windows/Linux三平台Spotify下载器一条命令部署指南
Sunnify 是一款免费、开源的 Spotify 下载器(Spotify playlist downloader),支持 macOS、Windows 和 Linux 三大平台。粘贴播放列表、专辑或单曲链接,它就能把整张歌单保存为带封面和音乐标签的本地 MP3、M4A、FLAC 等音频文件——不需要 Spotify 账号、不需要 API Key,FFmpeg 也已内置,开箱即用。本文将带你用一条命令完成三平台的 Sunnify 安装部署。
Sunnify Spotify 下载器功能总览:下载播放列表、专辑、单曲并写入封面与标签
一、安装前准备:零依赖,30 秒开始
Sunnify 的官方安装包做了充分的"减负",普通用户几乎不需要任何前置准备:
- ✅ 无需任何账号:不需要登录 Spotify,也不需要配置 API Key
- ✅ FFmpeg 已内置:转码所需的 FFmpeg 直接打包在应用里,不用单独安装
- ✅ 无需管理员权限:安装脚本全程运行在用户目录下,不弹 sudo / UAC 提示
- ⏳ 唯一的网络要求:能正常访问网络即可,下载与转码都在本机完成
💡 只有"从源码运行"这一种进阶用法需要 Python 3.10+ 环境,详见第五节。
二、macOS / Linux 一键安装步骤
macOS(Apple Silicon / Intel 均可)和 Linux 共用同一个安装脚本 scripts/install.sh。把仓库克隆下来后,一条命令即可完成部署:
git clone https://gitcode.com/gh_mirrors/su/sunnify-spotify-downloader && cd sunnify-spotify-downloader && sh scripts/install.sh
脚本执行过程中会自动完成以下工作:
- 识别你的系统架构(macOS 的 arm64/x86_64、Linux 的 x86_64)并拉取对应的最新发布包
- 用 SHA256 校验文件完整性(校验机制详见 SECURITY.md)
- 完成安装并配好
sunnify命令行
| 平台 | 安装位置 | 说明 |
|---|---|---|
| macOS | ~/Applications/Sunnify.app + ~/.local/bin/sunnify |
自动清除系统隔离标记,首次打开不会被拦截 |
| Linux | ~/.local/bin/sunnify |
直接运行可执行文件,无参数时打开图形界面 |
🍺 macOS 补充:如果你习惯 Homebrew,也可以用 Cask 安装——仓库内置的 Casks/sunnify.rb 会自动选择对应架构版本、校验下载文件并清理隔离属性,同样无需额外配置。
如果脚本提示 ~/.local/bin 不在 PATH 中,把下面这行加入你的 shell 配置文件(如 ~/.bashrc 或 ~/.zshrc):
export PATH="$HOME/.local/bin:$PATH"
三、Windows 一键安装步骤
Windows 版本使用 PowerShell 安装脚本 scripts/install.ps1。克隆仓库后,一条命令完成部署:
git clone https://gitcode.com/gh_mirrors/su/sunnify-spotify-downloader; cd sunnify-spotify-downloader; powershell -ExecutionPolicy Bypass -File scripts\install.ps1
脚本会自动完成:下载最新发布的 Windows 版 → SHA256 校验 → 安装到 %LOCALAPPDATA%\Sunnify → 把该目录加入用户级 PATH(无需管理员权限)。
⚠️ PATH 写入后,已打开的终端窗口不会立即生效,请新开一个 PowerShell 或 CMD 窗口再输入
sunnify。
另外,官方发布的 Sunnify-Windows.exe 也可以双击直接运行,完全免安装,适合只想先试试看的用户。
四、验证安装结果:sunnify doctor 自检
安装完成后,建议花 10 秒验证一下环境是否就绪。每个 Sunnify 二进制都自带无窗口 CLI(完整命令参考 docs/CLI.md):
sunnify --version # 查看版本号
sunnify doctor # 自检:FFmpeg、配置、网络连通性、版本新旧
sunnify --help # 查看全部命令
doctor 命令会逐项检查 FFmpeg 是否可用、配置文件是否正常、Spotify 页面是否可达等,全部通过就可以放心使用了。
日常使用非常简单,四步搞定:
- 复制一个 Spotify 播放列表 / 专辑 / 单曲链接
- 粘贴进 Sunnify
- 在设置里选择格式(MP3、M4A、Opus、FLAC、WAV)和音质
- 点击 Download,边下边看进度,随时可停止
Sunnify Spotify 下载器桌面界面演示:粘贴链接后逐曲下载并写入标签
命令行同样支持全部功能,比如:
sunnify download "https://open.spotify.com/playlist/..." # 下载播放列表
sunnify info "<url>" --json # 只获取元数据
五、从源码运行(进阶,可选)
如果你是开发者,想直接运行源码,需要 Python 3.10+(FFmpeg 预编译版已内置,源码运行则需系统里可找到 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
依赖清单见 req.txt,主程序入口为 Spotify_Downloader.py。打包独立应用可参考 Sunnify.spec(PyInstaller 配置)。
六、安装失败?3 个常见问题排查
| 现象 | 解决方法 |
|---|---|
| macOS 提示"无法打开,因为身份不明" | 执行 xattr -r -d com.apple.quarantine ~/Applications/Sunnify.app 清除隔离标记,或到 系统设置 → 隐私与安全性 中点击"仍要打开" |
终端提示 sunnify: command not found |
~/.local/bin(或 %LOCALAPPDATA%\Sunnify)未加入 PATH,按第二、三节说明添加后重开终端 |
| 下载中途失败 / 被限流 | Sunnify 自带断点续传:直接重跑同一条 sunnify download 命令,已下载的歌曲会自动跳过 |
🔄 更新也很简单:直接重跑一次安装命令即可,两个脚本都是幂等的,会就地替换旧版本。
七、合法使用提醒
Sunnify 是一个教育性质的技术演示项目,请仅下载你拥有版权或已获得授权的内容,并遵守所在地区的法律法规。完整的法律条款见 DISCLAIMER.md。
小结:Sunnify 通过 scripts/install.sh(macOS/Linux)和 scripts/install.ps1(Windows)实现了真正的"克隆 + 一条命令"安装——自动识别架构、校验完整性、零管理员权限。现在打开终端,把上面对应平台的命令复制粘贴,你的 Spotify 下载器就已部署完成 🎧