SpotiFlyer安装教程：快速上手Android/Windows/macOS/Linux/Web全平台音乐下载器
【免费下载链接】SpotiFlyerKotlin Multiplatform Music Downloader, Supports Spotify / Gaana / Youtube Music / Jio Saavn / SoundCloud.项目地址: https://gitcode.com/gh_mirrors/sp/SpotiFlyer
SpotiFlyer 是一款基于 Kotlin Multiplatform 开发的免费开源全平台音乐下载器，支持 Spotify、YouTube Music、Gaana、Jio Saavn、SoundCloud 五大音乐平台，可下载单曲、专辑与整个播放列表，全程无需配置任何 API Key，安装后开箱即用。本教程将带你 5 分钟完成 Android / Windows / macOS / Linux / Web 五大平台的一键安装与首次下载。
🎵 为什么选择 SpotiFlyer 音乐下载器
| 亮点 | 说明 |
|---|---|
| 🌐 多平台源 | Spotify / YouTube / YouTube Music / Gaana / Jio-Saavn / SoundCloud |
| 📥 批量下载 | 支持单曲、专辑、播放列表整单下载 |
| 🚫 无广告 | 完全免费，无任何广告干扰 |
| 🔑 零配置 | API 密钥已内置，无需注册、无需折腾 |
| 🧱 本地存储 | 下载后保存为 MP3，离线也能听 |
项目主体由多个 Gradle 模块构成，各平台共享同一套核心逻辑，模块结构可在 settings.gradle.kts 中查看，平台源码分别位于 android/、desktop/、web-app/ 目录。
📦 各平台安装步骤
1️⃣ Android 安装（推荐，APK 一键安装）
- 在项目 Releases 页面下载
SpotiFlyer-x.x.x.apk文件（稳定版）； - 传到手机后点击安装，允许"安装未知来源应用"；
- 首次启动授予存储与网络权限即可开始使用。
应用权限说明（网络、存储、前台下载服务等）可在 android/src/main/AndroidManifest.xml 中逐项查看。
2️⃣ Windows 安装（MSI 图形化安装）
- 在 Releases 页面下载
SpotiFlyer-x.x.x.msi； - 双击运行安装向导，全程"下一步"即可完成；
- 若偏好绿色免安装，可下载
SpotiFlyer-windows-x64-x.x.x.jar，需要本机已安装Java（JRE 11+），执行java -jar SpotiFlyer-windows-x64-x.x.x.jar启动。
桌面端入口代码见 desktop/src/jvmMain/kotlin/Main.kt，窗口默认 450×800 尺寸，界面与手机端保持一致。
3️⃣ macOS 安装（使用 JAR 版）
⚠️ 注意：官方说明 macOS 的 DMG 未做签名公证，建议直接使用 JAR 版本。
- 下载
SpotiFlyer-macos-x64-x.x.x.jar； - 确保已安装 Java；
- 终端执行
java -jar SpotiFlyer-macos-x64-x.x.x.jar即可启动。
4️⃣ Linux 安装（DEB / JAR 二选一）
方式一：DEB 包（Debian/Ubuntu 系）
- 下载
spotiflyer_x.x.x-1_amd64.deb； - 双击或用
sudo apt install ./spotiflyer_x.x.x-1_amd64.deb安装。
方式二：JAR 绿色版
下载SpotiFlyer-linux-x64-x.x.x.jar后运行java -jar SpotiFlyer-linux-x64-x.x.x.jar。
💡 桌面版依赖 FFmpeg 进行音频处理，JAR 版若提示"FFmpeg not found at path"，请确认系统已安装 FFmpeg 并在 PATH 中。
5️⃣ Web 版：免安装，浏览器直接打开
Web 端处于 Beta 状态，打开浏览器访问官方 Web 页面即可使用，无需安装任何组件，适合临时下载一两首歌的场景，移动端浏览器同样支持。
🔍 首次使用：三步完成第一个音乐下载
- 粘贴链接：在 Spotify / YouTube Music 等平台复制歌曲、专辑或播放列表链接，粘贴到首页搜索框；
- 选择来源：应用会自动从可用平台（如 YouTube Music、JioSaavn）匹配歌曲，点击歌曲选择下载来源；
- 开始下载：在设置页选择下载目录（Android 默认为 Music 目录，桌面端可自选文件夹），点击 Download 即可后台批量下载，支持断点续传式进度展示。
下载列表、历史记录与设置界面由 common/compose/src/commonMain/kotlin/com/shabinder/common/uikit/screens/SpotiFlyerMainUi.kt 实现，各平台体验一致。
⚠️ 常见问题与注意事项
- 地域限制：YouTube Music / JioSaavn 在你所在地区可用时，匹配与下载效果最佳；
- Java 环境：所有 JAR 版本均要求先安装 Java；
- 后台下载：Android 端通过前台服务下载，锁屏退出应用后下载不中断；
- 多语言：应用内置 20+ 种语言翻译，语言文件位于 translations/ 目录；
- 版权提示：下载受版权保护的音乐可能在你所在地区违反法规，本项目仅用于学习各平台 API，请支持正版音乐、尊重创作者。
📌 小结
| 平台 | 安装方式 | 状态 |
|---|---|---|
| Android | APK 直装 | ✅ 稳定 |
| Windows | MSI / JAR | ✅ 稳定 |
| macOS | JAR | ✅ 稳定 |
| Linux | DEB / JAR | ✅ 稳定 |
| Web | 浏览器访问 | ⚠️ Beta |
跟随本文步骤，你现在应该已在自己的设备上装好了 SpotiFlyer。更多项目详情与更新动态可查阅 README.md；想为项目贡献翻译或文档，可参考 CONTRIBUTING.md 参与共建。
【免费下载链接】SpotiFlyerKotlin Multiplatform Music Downloader, Supports Spotify / Gaana / Youtube Music / Jio Saavn / SoundCloud.项目地址: https://gitcode.com/gh_mirrors/sp/SpotiFlyer
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
