Spotube 开源音乐播放器——插件驱动、跨平台、零遥测的去中心化音乐体验
关于本站：第三方整理的中文文档站，非官方页面；内容来自公开资料整理，功能与界面以官方最新版为准。
Spotube 是什么
Spotube 是一款由 Flutter 原生构建的开源跨平台音乐流媒体客户端，面向想摆脱付费订阅又不愿放弃完整体验的音乐爱好者。v5.0.0 起全面转向 插件驱动架构：元数据、音频流、歌词、scrobbling 全部解耦，社区可通过 Kotlin/JS + Zipline 运行时编写扩展，打包成 .smplug 即可加载。
Spotube 在 GitHub 上已累计 50k+ stars、2.3k+ forks，BSD-4 开源协议允许自由修改与分发，官方承诺零遥测、零诊断、零用户数据收集——播放控制完全在本地完成，不走服务器。
产品档案速览
| 项目 | 详情 |
|---|---|
| 最新版本 | v5.1.0（2025-11-14） |
| 技术栈 | Flutter / Dart / Kotlin / Zipline |
| 许可证 | BSD-4-Clause |
| 开发模式 | 社区驱动（KRTirtho 为主维护） |
| 支持平台 | Android / iOS / Windows / macOS / Linux |
| 仓库 stars | 约 50,000 |
| 安装包体积 | Android APK 约 125MB |
| 官方文档站 | docs.spotube.cc |
结构导览
内容按 Spotube 的插件驱动架构展开：
- 项目定位——去中心化音乐生态、BSD-4 协议与隐私承诺
- 多平台安装——Android、Windows、macOS、Linux、iOS 各自的安装方式
- 插件系统——v5 起的核心能力：元数据插件、Audio-Source 插件、官方插件矩阵
- 播放器内核——MPV 引擎、队列、歌词、下载、均衡器、FLAC
- 歌单与音乐库——Spotify 同步、本地库、收藏与发现
- 插件开发——Kotlin/JS + Zipline 环境搭建、API 接口、打包分发
- 设置与个性化——主题、默认源、快捷键、存储
- 故障排查——跳帧、插件加载失败、下载卡住等常见问题
重要提示
Spotube 与 PyPI 上同名的 Python 包（一个 Spotify 歌单下载脚本）不是同一个项目——两者无关联，本文档介绍的是 Flutter 编写的 GUI 客户端。