MusicFreePlugins：MusicFree 播放器插件包，12 个音乐源与 3 个歌词、本地曲库玩法

MusicFreePlugins：MusicFree 播放器插件包，12 个音乐源与 3 个歌词、本地曲库玩法

【免费下载链接】MusicFreePluginsMusicFree播放插件项目地址: https://gitcode.com/gh_mirrors/mu/MusicFreePlugins

想听的歌散落在不同平台，常常要在几个 App 之间来回切换，才能凑齐一首能完整播放、带歌词的歌。MusicFreePlugins 是 MusicFree 播放器的一套开源插件：它把 bilibili、Navidrome、快手、suno 等 12 个源接进同一个搜索框，仓库已默认过滤 VIP 和收费内容。装好之后，你不需要离开播放器，就能完成多平台搜索、音质切换和歌单导入。

先跑通一个最小闭环

1. 安装 MusicFree 播放器并更新到较新版本。插件依赖播放器协议，老版本可能不兼容。确认方式：玩家“关于”页能看到版本号。
2. 把仓库克隆到本地：

git clone https://gitcode.com/gh_mirrors/mu/MusicFreePlugins

这条命令把全部插件源码拉到本地，根目录的plugins.json是插件“菜单”，每个条目带name、url、version三个字段。 3. 打开plugins.json，找到 bilibili 和 歌词千寻 两条，复制它们的url值。 4. 在播放器插件管理里选“从 URL 安装”，逐个粘贴；如果已在仓库执行过npm run build，也可以用“从本地安装”选dist/下对应的index.js。确认方式：已安装列表出现这两个插件名。 5. 搜索一首你熟悉的歌。确认方式：出现带平台标识的结果、点开能播放、歌词能带出文字，最小闭环即打通。

能力全景

bilibili 插件另有两项附加能力：公开收藏夹整单导入、内置榜单，播放时还能拉取评论。注意 Airsonic 的源码在仓库plugins/下，但plugins.json当前未收录其入口，具体以仓库最新版本为准。

三个场景配方

场景一：日常找歌，多平台合一

场景：不想逐个打开 App，一个框把歌找全。 步骤：装 bilibili 加 歌词千寻；用“歌名 + 歌手”的短组合搜索；移动数据下选 standard 档，回家换 high 档；歌词缺失时由歌词插件补齐。 预期效果：一个搜索框同时返回多个平台的结果，播放和歌词闭环完成。

场景二：bilibili 收藏夹整单导入

场景：把公开的 bilibili 收藏夹搬成播放器里的日常播放列表。 步骤：H5 或 PC 端复制收藏夹 URL，也可以直接输入收藏夹 ID；收藏夹必须是公开状态，否则导不进来；在播放器导入入口粘贴链接；歌单较大时导入耗时较长，耐心等待。 预期效果：收藏里的曲目全部进入播放器，按列表顺序播放。

场景三：接入本地曲库，以 Navidrome 为例

场景：NAS 或网盘里的音频，变成可搜索、可播放的曲库。 步骤：安装 Navidrome 插件；在弹窗里填写服务器地址、用户名、密码；地址保留http://或https://前缀；本地库搜索后直接播放。 预期效果：自己的音频不受任何平台规则影响，随时可听。

常见坑

从 URL 安装失败？先检查plugins.json里的url是否完整复制，再确认当前网络能否访问托管地址；仍失败就尝试升级播放器版本。

搜索结果为空怎么修？把过长或生僻的关键词改成“歌名 + 歌手”的短组合，并确认插件是仓库最新版本。

播放到一半卡住？把音质档位降一档重试，同时检查代理设置是否影响了音频流。

歌单导入报错？非公开收藏夹无法导入，先到原站改成公开，再按插件hints提示重新复制链接。

自建服务连不上？多数是地址漏了http://或https://前缀，或账号密码填错；回到用户变量输入界面重新填写并保存。

写好的插件怎么验证？参考test/目录下的同类脚本，在仓库里用ts-node执行对应的测试命令本地调试。

插件属学习示例，数据来自网络公开接口，VIP、收费与试听内容已过滤，请只用于学习和个人合理使用，不商用、不绕过付费内容。下一步动作：先装上 bilibili 和 歌词千寻，再导入一个收藏夹，把整条流程走一遍。

【免费下载链接】MusicFreePluginsMusicFree播放插件项目地址: https://gitcode.com/gh_mirrors/mu/MusicFreePlugins