MusicFree 免费音乐播放器上手指南：从装插件到日常听歌
【免费下载链接】MusicFree插件化、定制化、无广告的免费音乐播放器项目地址: https://gitcode.com/GitHub_Trending/mu/MusicFree
主流音乐 App 里广告、会员墙和强制登录几乎成了标配，想听歌得先掏钱。MusicFree 是另一个思路：一个开源、无广告的免费音乐播放器，本身不带任何音源，你想听什么平台的歌，取决于你装什么插件。
它是什么，适合什么人 🎧
一句话：MusicFree 是一个基于 React Native 的免费播放器，专为不想看广告、不想被会员墙拦住的人设计。它最鲜明的三个标签是：插件化（搜索、播放、歌单、歌词全部由插件提供）、无广告且开源免费（AGPL 3.0）、数据全部本地存储不上传。它支持 Android 和 Harmony OS，iOS 暂不支持，这点和很多 App 不同，选它前请确认系统。
怎么拿到 MusicFree 并跑起来
- 到仓库的发布页下载 APK，选择与你手机架构匹配的版本；
- 安装后首次启动，按系统提示授予存储、通知等权限；
- 打开侧边栏 → 插件管理，装好至少一个插件；
- 回首页搜一首歌，能出结果就说明跑通了。
音乐源插件怎么装
装插件是 MusicFree 里最关键的一步，装完播放器才真正"通电"。进入侧边栏 → 插件管理，点"从网络安装"，粘贴插件地址确认即可；也支持打开本地 .js 文件直接安装。官方在 readme 里给了几个示例插件仓库可以照着装。
插件本质上是一组遵循插件协议的脚本，提供搜索（歌曲、专辑、作者）、播放、查看专辑与作者详情、导入歌单、获取歌词等能力。播放器不内置音源，装哪个插件就能用哪个源，这也是它和成品音乐 App 最大的区别。
从搜索到播放：日常听歌怎么走
先说入口：首页搜索框或榜单点进去，点任意歌曲就直接开始播。搜索结果由所有已启用的插件聚合而来，点歌曲进播放页，点专辑、作者则进入对应详情页，专辑页可以整张播放、单曲加入歌单。播放页可以切音质、切播放模式，歌单支持排序与批量操作；本地文件也能用 MusicFree 打开播放。
歌词不同步、没有歌词怎么办
歌词页支持逐行同步、拖动进度、调整字体大小，还能自动搜索缺失的歌词、显示翻译。没有歌词时，可以在歌曲选项里把歌词关联到另一首有歌词的歌，关联后两首共用同一份歌词，也支持 A 指向 B、B 指向 C 的链式关联；偏移不对就在歌词操作里调偏移量。
界面怎么改成自己喜欢的样子
界面改动全部即时生效，浅色、深色、自定义背景都可以随意搭配。入口在侧边栏 → 主题设置：切换深色/浅色模式；选自定义背景图，也可以让背景跟随封面色调变化。所有设置只存在本地，不会上传。
几个真正影响体验的设置
播放音质：默认"标准"。在基本设置 → 播放里可改成低、高或超高。改完立即生效，高音质更耗流量和缓存。
移动网络播放：默认关闭。在基本设置 → 网络里打开开关，改完不连 Wi-Fi 也能直接播；下载流量开关单独控制，建议按需打开。
播放失败自动换源：默认关闭。开启后某个源拿不到播放链接时，会自动尝试其他源的同名歌曲，适合装了多个插件的用户。
遇到问题先翻这里
- 插件装不上 → 多为网络或插件地址失效，先确认能联网，再换一个可靠的插件来源重试。
- 歌点不了、没声音 → 先确认该插件开关是打开的、该源支持这首歌；换个插件源或切回 Wi-Fi 再试。
- 歌词对不上 → 进歌词操作调整偏移量；没有歌词就开启自动搜索或关联歌词。
后续版本变化可以看 changelog.md，歌单与插件配置可以在设置里的"备份与恢复"中导出。有想法或问题，去仓库提 issue，或到 src 目录 里找答案。
【免费下载链接】MusicFree插件化、定制化、无广告的免费音乐播放器项目地址: https://gitcode.com/GitHub_Trending/mu/MusicFree
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
