MusicFree README

The project's README from github.com/maotoumao/MusicFree. As one markdown file: README.md.

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

maotoumao%2FMusicFree | Trendshift

简介

一个插件化、定制化、无广告的免费音乐播放器,目前只支持 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 以及引流,并未遵守本项目的开源协议,且拒绝沟通。


特性

插件

插件简介

插件本质上是一个满足插件协议的 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 样例,软件内部不提供任何音源,不代表实际使用时表现如下图。

主界面

主界面

侧边栏

侧边栏 基础设置 主题设置

音乐相关

歌单页 歌单内检索 播放页 歌词页

搜索相关

作者信息
以下是软件早期版本的 UI

主界面

主界面

侧边栏

  • 基础设置
基础设置
  • 主题设置
主题设置

音乐相关

  • 歌单页
歌单页
  • 歌单内检索
歌单内检索
  • 播放页
播放页
  • 歌词页
歌词页

搜索相关

  • 作者信息
作者信息

MusicFree (maotoumao/MusicFree)

Searching Database…

27.6K ·GitHub
What is this?A free, open-source, ad-free music player for Android and HarmonyOS. The app itself is only a player — it bundles no music sources; searching, playback and playlists all come from plugins you install.
So how does it actually find music if the app ships with no sources?Through plugins. Each plugin is a commonjs module that implements the search, playback and import logic, while pagination and caching are handled by MusicFree itself — so any internet source works as long as a plugin exists for it.
How do I get it working on my phone?Install the app, then open the sidebar's Plugin Settings — plugins can be added from a local file or from the web (.js plugin files and .json descriptors are both supported). The author links a repo of example plugins.
How stable is it day to day?It's a hobby project: the author gets roughly half an hour a day for it, so expect a long stretch of unstable beta versions with irregular updates. Use it with that in mind.
Is there an iPhone or desktop version?No iPhone build: the README says only Android and HarmonyOS are supported, though it announces a desktop version as newly released.
I saw a paid MusicFree in an app store — is that this app?No. Any paid, 'no-ads' or cracked copy sold elsewhere is fake — report it. The MusicFree listings on Xiaomi, Huawei and vivo app stores are unrelated adware that just copied the name and logo.
What can a plugin actually do?Search for music, albums and artists; play tracks; open album and artist pages; import singles and whole playlists; and fetch lyrics.
Can it play VIP or paid songs for free?No. The example plugin repo wraps public APIs and filters out all VIP, preview-only and paid tracks, and the author says cracking plugins will never be provided — you can build your own offline music library instead.
Can I link the lyrics of one song to another?Yes. Link song A's lyrics to song B and both songs will display B's lyrics; chains like A -> B -> C work too, with all three showing C's lyrics.
Creator
maotoumao
Size
21.8 MB
Stars
27.6K
Age
4y
Commits · 90 Days