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

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

技术背景

MusicFree 是一款插件化、定制化且无广告的免费音乐播放器,目前仅支持 Android 和 Harmony OS 系统,同时也有桌面版。该软件基于 AGPL 3.0 协议开源,其设计理念是通过插件来实现各种功能,本身不集成任何平台的音源,专注于打造一个功能完善的播放器。

实现步骤

插件开发

插件本质上是满足插件协议的 commonjs 模块,开发者需定义搜索(音乐、专辑、作者)、播放、查看专辑、作者详细信息、导入歌单、获取歌词等基本函数,而分页、缓存等功能由 MusicFree 控制。插件开发文档可参考此处

插件使用

  1. 下载 app 后,在侧边栏设置 - 插件设置中安装插件。支持安装本地插件和从网络安装插件,可解析.js 文件和.json 描述文件。
  2. 可直接点击从网络安装插件,输入https://gitee.com/maotoumao/MusicFreePlugins/raw/master/plugins.json,点击确认即可安装。
  3. 图文版详细使用说明可参考公众号:MusicFree 插件使用指南,或者站点:https://musicfree.catcat.work/usage/mobile/install-plugin.html

软件下载

可转到发布页查看下载地址(若打不开可把 github 换成 gitee),也可在公众号回复 Musicfree 获取。

核心代码

文档中未给出核心代码示例,若要查看具体代码,可前往 MusicFree 的 GitHub 仓库

最佳实践

  • 对于开发者而言,若想开发插件,可参考已有的示意插件代码,深入理解插件协议和输入输出逻辑。
  • 对于普通用户,在使用第三方下载的插件时,要自行鉴别插件的安全性,防止恶意代码破坏。同时,及时删除插件使用过程中产生的可能涉及版权的数据。

常见问题

使用时遇到的常见问题可查看 MusicFree 使用 Q&A。技术交流可加群:683467814(非答疑群),闲聊可到 QQ 频道。若有新需求,可在公众号后台留言、提 issue 或者去 discussion 开话题。


插件化、定制化、无广告的免费音乐播放器——MusicFree
https://119291.xyz/posts/2025-04-23.plugin-customizable-ad-free-music-player-musicfree/
作者
ww
发布于
2025年4月23日
许可协议