MusicFree

maotoumaoAGPL-3.0活跃维护

插件化、可定制的免费音乐播放器,通过插件接入不同音乐源,无广告干扰,支持 React Native 跨平台使用。

插件化、定制化、无广告的免费音乐播放器

v1.0.0-beta.4发布于 2026-10-15 15:16 UTC28,434star +110 / 7 天2,023fork同步于 2026-11-10 23:24 UTC

怎么上手

由 README 提炼,执行前请确认
从 https://github.com/maotoumao/MusicFree/releases 下载安装包;安装后在侧边栏设置-插件设置中从网络安装插件,输入 https://raw.gitcode.com/maotoumao/MusicFreePlugins/raw/master/plugins.json
硬件要求按 README 说明

README 未说明;软件目前只支持 Android 和 Harmony OS,桌面版为另一个独立仓库

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

插件化无广告的免费音乐播放器,本身不带音源,靠插件实现搜索播放

插件化、可定制的免费音乐播放器,通过插件接入不同音乐源,无广告干扰,支持 React Native 跨平台使用。

核心能力

  • 插件化架构,搜索播放歌单导入全部依赖插件
  • 插件支持搜索音乐专辑作者、播放、导入歌单与歌词
  • 歌词关联,可把多首歌的歌词链式关联到同一首
  • 数据全部本地存储,不收集个人信息
  • 提供浅色深色模式与自定义背景

容易踩的坑

软件本身不集成任何音源,不装插件无法搜索播放;第三方插件需自行鉴别安全性,来路不明的插件不要装;应用市场里同名同 Logo 的 MusicFree 与本项目无关,是广告软件

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v1.0.0-beta.4
  1. v1.0.0-beta.41.0.0-beta.4pre-release最新正式版2026-10-15 · 2026-10-15 15:16 UTC

    更新日志

    恢复

    • 恢复「允许与其他应用同时播放」设置,默认关闭,切换后立即生效。

    新增

    • 恢复备份时的插件来源确认:展示插件及订阅来源地址,确认信任后才能恢复相关内容。

    优化

    • 完善 WebDAV 错误提示,区分认证失败、权限不足、文件不存在、请求限流、存储配额不足及服务端不支持等情况。
    • 增加 WebDAV 应用授权密码提示及请求诊断,方便排查连接问题。
    • 降低从本机文件和链接读取大备份时的内存峰值。

    修复

    • 修复部分已下载歌曲移动并重新扫描后,仍使用在线音源或在本地列表播放失败后跳过的问题。
    • 调整 WebDAV 备份上传方式,兼容坚果云等不支持 MOVE 覆盖已有文件的服务。
    • 修复部分 WebDAV Digest 认证失败时,上传或发布仍被误报为成功的问题。
    • 完善 WebDAV 恢复时的实际文件大小校验。
    • 修复从链接恢复备份时,取消操作后仍占用状态、阻止后续备份的问题。
    • 修复已恢复但尚未安装对应音源的歌曲配置,再次备份时被遗漏的问题。
    • 修复恢复插件后,插件顺序在重启时发生变化的问题。
    • 修复部分歌曲导出字段不完整的问题。
    • 修复旧备份缺少创建时间时显示错误时间的问题,改为显示「备份时间未知」。
    • 修复滑动歌词时,时间提示和跳转位置可能超过歌曲总时长的问题;总时长未知时不显示定位入口。
  2. v1.0.0-beta.31.0.0-beta.3pre-release2026-09-13 · 2026-09-13 14:28 UTC
    查看更新说明
    1. 修复歌曲详情页手机横屏显示异常,调整了横屏下的布局
    2. 补上下载路径的选择入口,在「设置 → 下载」里可以修改
    3. 修复扫描音乐时漏掉 SD 卡的问题
    4. 歌单、本地音乐等列表支持一键定位正在播放的歌曲
    5. 歌词页正在播放的歌词会用主题强调色高亮
    6. 修复 WebDAV 备份恢复一直没反应的问题,超时会给出提示
    7. 修复部分本地音乐的歌名、歌手乱码,重新扫描后会尝试修正,不会修改音乐文件
    8. 插件安装失败的提示更具体了,复制链接时混进的不可见字符也会自动清理
    9. 减少了播放失败时的重复请求
    10. 修复部分直链、WebDAV 歌曲有内嵌封面,但播放页不显示的问题
    11. 调整了设置背景图片时候的取色逻辑和主题
    12. 本地扫描默认排除部分常见录音目录,并识别 .nomedia 标记,减少扫进录音、缓存音频的情况
    13. 「下载完成后加入本地音乐」挪到「设置 → 下载」,默认开启,之前手动关闭的会保留
    14. 歌单数据损坏或迁移异常时,会留下更明确的错误日志,方便排查
  3. v1.0.0-beta.21.0.0-beta.2pre-release2026-09-06 · 2026-09-06 16:13 UTC
    查看更新说明

    修复了一些bug

  4. v1.0.0-beta.1pre-release2026-09-06 · 2026-09-06 10:54 UTC
    查看更新说明

    重写了软件. 完整代码会随正式版一起更新到主分支

  5. v0.6.3-beta.1pre-release2026-01-06 · 2026-01-06 14:15 UTC
    查看更新说明
    • 【功能】 侧边栏-权限管理中新增 "忽略电池优化" 开关,总被杀后台的小伙伴可以试试~
    • 【功能】 新增了错误日志和首屏性能的埋点 (只是加个埋点方便排查问题~ 这部分代码也是开源的~)
    • 【修复】 修复了切换音质面板多语言错误的问题
    • 【修复】 修复部分情况下本地音乐无法播放的问题

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    MusicFree

    中文 | English

    GitHub Repo stars GitHub forks star

    GitHub License GitHub Downloads (all assets, all releases) GitHub Issues or Pull Requests GitHub package.json version

    简介

    一个插件化、定制化、无广告的免费音乐播放器,目前只支持 Android 和 Harmony OS。

    桌面版来啦:https://github.com/maotoumao/MusicFreeDesktop

    如果需要了解后续进展可以关注公众号↓;如果有问题可以在 issue 区或者公众号直接留言反馈。

    微信公众号

    软件下载方式、插件使用说明、插件开发文档可去站点 https://musicfree.catcat.work 查看。

    [!NOTE]

    • 如果你在其他的平台看到收费版/无广告版/破解版,都是假的,本来就是开源项目,遇到收费版请直接举报;
    • 软件首先是自用,顺带分享出来希望可以帮助到有需要的人;是业余作品,会尽量保持维护,不过每天能写的时间有限(半小时左右),目测会有很长一段时间处于不稳定测试版本,且更新频率不定,请谨慎使用;
    • 软件的第三方插件、及其所产生的数据与本软件无关,请合理合法使用,可能产生的版权数据请及时删除。
    • 请不要以 VIP/破解版为噱头进行宣传,示例仓库基于互联网公开接口封装,并过滤掉所有 VIP、试听、付费歌曲,且示例仓库以后也不会提供具备破解功能的插件;
    • 本软件的相关信息只会主动投放在 Git 仓库以及公众号“一只猫头猫”中,如果希望写文章介绍本软件请自便,但还烦请如实陈述,涉及到示例仓库请给插件源打个码,不要给软件增加一些不实的功能(尽管我也想有);描述冲突的地方以本仓库为准。

    项目使用约定:

    本项目基于 AGPL 3.0 协议开源,使用此项目时请遵守开源协议。
    除此外,希望你在使用代码时已经了解以下额外说明:

    1. 打包、二次分发 请保留代码出处:https://github.com/maotoumao/MusicFree
    2. 请不要用于商业用途,合法合规使用代码;
    3. 如果开源协议变更,将在此 Github 仓库更新,不另行通知。

    [!CAUTION]

    👎 Hall of Shame

    👎 小米/华为/vivo等应用市场的 MusicFree 和本软件无关,是套用本软件名称和 Logo 的广告软件。

    👎 速悦音乐基于本软件二次开发,改动点仅仅是内置插件、修改一些 UI 以及引流,并未遵守本项目的开源协议,且拒绝沟通。


    特性

    • 插件化:本软件仅仅是一个播放器,本身并不集成任何平台的任何音源,所有的搜索、播放、歌单导入等功能全部基于插件。这也就意味着,只要可以在互联网上搜索到的音源,只要有对应的插件,你都可以使用本软件进行搜索、播放等功能。关于插件的详细说明请看插件一节。

    • 插件支持的功能:搜索(音乐、专辑、作者)、播放、查看专辑、查看作者详细信息、导入单曲、导入歌单、获取歌词等。

    • 定制化、无广告:本软件提供了浅色、深色模式;支持自定义背景;本软件基于 AGPL 协议开源,一个 star 做交易 将会保持免费。

    • 隐私:所有的数据都存储在本地,本软件不会收集你的任何个人信息。

    • 歌词关联:你可以把两首歌的歌词关联起来,比如将歌曲 A 的歌词关联到歌曲 B,关联后 A、B 两首歌都将显示歌曲 B 的歌词。你也可以关联多首歌的歌词,如 A->B->C,这样 A、B、C 三首歌都将显示 C 的歌词。

    插件

    插件简介

    插件本质上是一个满足插件协议的 commonjs 模块。插件中定义了搜索(音乐、专辑、作者)、播放、查看专辑、作者详细信息、导入歌单、获取歌词等基本函数,插件的开发者只需要关心输入输出逻辑,至于分页、缓存等全都交给 MusicFree 控制即可。本软件通过插件来完成播放器的所有功能,这样解耦的设计也可以使得本软件可以专注于做一个功能完善的播放器,我直呼小而美。

    插件开发文档可以参考 这里

    需要注意的是:

    • 如果你是使用第三方下载的插件,那么请自行鉴别插件的安全性(基本上看下没有奇怪的网络请求什么的就好了;自己写的最安全,不要安装来路不明的东西),防止恶意代码破坏。因为第三方恶意插件导致的可能的损失与本软件无关。

    • 插件使用过程中可能会产生某些和本软件无关的版权数据,插件、以及插件产生的任何数据与本软件无关,请使用者自行斟酌,及时删除数据,本软件不提倡也不会提供任何破解行为,你可以搭建自己的离线音乐仓库使用。

    插件使用

    下载 app 之后,只需要在侧边栏设置-插件设置中安装插件即可。支持安装本地插件和从网络安装插件(支持解析.js 文件和.json 描述文件;已经写了几个示意的插件:指路这个仓库,不过可能功能不是很完善);

    你可以直接点击从网络安装插件,然后输入https://raw.gitcode.com/maotoumao/MusicFreePlugins/raw/master/plugins.json ,点击确认即可安装。

    图文版详细使用说明可以参考公众号:MusicFree 插件使用指南,或者站点: https://musicfree.catcat.work/usage/mobile/install-plugin.html

    下载地址

    请转到发布页查看:指路 (如果打不开可以把 github 换成 gitcode),公众号回复 Musicfree 也可以。

    Q&A

    使用时遇到的常见问题可以看这里:MusicFree 使用 Q&A

    技术交流/一起写点有意思的东西/技术向的闲聊欢迎加群:683467814~ (不是答疑群)

    闲聊可以到 QQ 频道~

    WIP

    如果有需要讨论的新需求,可以在公众号后台留言/提issue/或者去discussion开个话题。

    支持这个项目

    如果你喜欢这个项目,或者希望我可以持续维护下去,你可以通过以下任何一种方式支持我;)

    1. Star 这个项目,分享给你身边的人;
    2. 关注公众号👇或 b 站 不想睡觉猫头猫 获取最新信息;
    3. 关注猫头猫的 小红书,虽然可能不会在这里更新软件相关的信息,但也算支持啦~

    微信公众号

    感谢以下小伙伴的推荐,很意外也很惊喜 ~~~

    来自果核剥壳的安利~ https://mp.weixin.qq.com/s/F6hMbLv_a-Ty0fPA_0P0Rg

    来自小棉袄的安利~ https://mp.weixin.qq.com/s/Fqe3o7vcTw0KDKoB-gsQfg

    ChangeLog

    点击这里


    本项目仅供学习参考使用,基于 AGPL3.0 协议开源;请在符合法律法规的情况下合理使用本项目,禁止用于商业目的使用。

    应用截图

    以下截图仅为 UI 样例,软件内部不提供任何音源,不代表实际使用时表现如下图。

    主界面
    侧边栏
    • 侧边栏
    • 基础设置
    • 主题设置
    音乐相关
    • 歌单页
    • 歌单内检索
    • 播放页
    • 歌词页
    搜索相关
    • 作者信息
    主界面
    侧边栏
    • 基础设置
    • 主题设置
    音乐相关
    • 歌单页
    • 歌单内检索
    • 播放页
    • 歌词页
    搜索相关
    • 作者信息