企业官网建设流程全解析

Spotube插件配置指南：3步安装元数据与音源插件，让播放器支持任意音乐平台

【免费下载链接】spotube🎧 Open source music streaming app! Available for both desktop & mobile!项目地址: https://gitcode.com/GitHub_Trending/sp/spotube

Spotube 是一款开源、可扩展的跨平台音乐流媒体播放器，支持桌面端与移动端。它的最大亮点是强大的插件系统：通过安装 Spotube 插件（元数据插件与音源插件），你可以让播放器接入任意音乐平台的曲库、专辑封面、歌词与音频流。本文用 3 步带你完成 Spotube 插件的安装与配置，零代码基础也能轻松上手 🎧。

先搞懂：Spotube 插件分两种

Spotube 的插件体系把"从哪里找歌"和"从哪放歌"拆成了两类能力：

一个插件可以同时具备两种能力。你在插件卡片上看到的Metadata/Audio Source标签就是它的能力标识，源码定义在 plugin.dart。

3步完成 Spotube 插件安装

第 1 步：打开插件管理页面

启动 Spotube，进入设置（Settings），点击顶部的Metadata Provider Plugins（插件）入口即可打开插件管理页面。该页面对应的源码是 metadata_plugins.dart。

第 2 步：安装插件（三选一）

插件页面提供三种安装方式：

1. 从「Available Plugins」列表直接安装：Spotube 会自动聚合社区公开的插件仓库，按All / Metadata / Audio Source三个标签页筛选。找到想要的插件点击安装即可，官方插件会带有Official标识。
2. 从 URL 安装：在页面顶部的输入框粘贴.smplug插件文件的直链地址，点击旁边的下载按钮，Spotube 会自动下载、校验并安装。
3. 本地文件上传：点击输入框右侧的上传按钮，选择本地的plugin.smplug文件，Spotube 会自动解压归档并完成安装（smplug本质是包含plugin.json清单的压缩包）。

第 3 步：设为默认音源 / 元数据来源并登录

安装完成后，回到已安装插件（Installed）列表：

• 点击Set as default metadata source：将该插件设为默认元数据来源；
• 点击Set as default audio source：将该插件设为默认音源；
• 若插件需要账号（如访问会员曲库），点击Login按提示完成登录，之后可随时Logout；
• 当插件有新版本时，卡片上会出现Update按钮，一键即可升级。

完成以上操作后，搜索框和播放队列就会使用新插件提供的曲库与音频流，相当于给播放器"换了一个音乐世界" 🚀。

内置插件：开箱即用

Spotube 仓库中自带了两个官方插件，可供参考或直接使用：

• 🎵YouTube 音源插件：assets/plugins/spotube-plugin-youtube-audio/plugin.smplug，提供 YouTube 音频流播放能力；
• 📀MusicBrainz/ListenBrainz 元数据插件：assets/plugins/spotube-plugin-musicbrainz-listenbrainz/plugin.smplug，提供元数据检索与打点支持。

你也可以通过"本地文件上传"把任意smplug文件装进自己的播放器。

⚠️ 安全须知：装插件前先看看来源

「Available Plugins」是一个未经人工审核的社区列表，第三方插件会带有醒目的警告标识。恶意插件理论上可以接触你的账号凭据，因此建议：

• 优先选择带Official标签的官方插件；
• 安装第三方插件前，点开仓库查看源码，确认作者可信；
• 不确定的插件坚决不装。

官方插件的识别逻辑见 installed_plugin.dart。

延伸阅读与相关文件

• 官方插件安装文档：website/src/content/docs/get-started/installing-plugins.mdx
• 插件开发入门（想自己写插件？）：website/src/content/docs/developing-plugins/introduction.mdx
• 插件数据模型：lib/models/metadata/plugin.dart
• 插件更新检查器：lib/provider/metadata_plugin/updater/update_checker.dart

💡 小贴士：Spotube 的插件使用类 Dart 的 Hetu Script 编写，如果你会 JavaScript/TypeScript，上手开发自己的元数据或音源插件会非常顺滑。

总结：只需"打开插件页 → 三选一安装 → 设为默认来源"这 3 步，Spotube 就能从一款播放器变成支持任意音乐平台的万能音乐站，尽情享受自由、开放、无广告的音乐流媒体体验吧 🎶。

【免费下载链接】spotube🎧 Open source music streaming app! Available for both desktop & mobile!项目地址: https://gitcode.com/GitHub_Trending/sp/spotube