1cfa0fc07S猫头猫# MusicFree 22cc1e122S猫头猫 32cc1e122S猫头猫> - 如果你在其他的平台看到收费版/无广告版/破解版，都是假的，本来就是开源项目，**遇到收费版请直接举报**； 46c803648S猫头猫> - 软件首先是自用，顺带分享出来希望可以帮助到有需要的人；是业余作品，会尽量保持维护，不过每天能写的时间有限（半小时左右），目测会有很长一段时间处于不稳定测试版本，且更新频率不定，请谨慎使用； 574acbfc0S猫头猫> - 软件的第三方插件、及其所产生的数据与本软件无关，请合理合法使用，可能产生的版权数据请及时删除。 62cc1e122S猫头猫> - **请不要以 VIP/破解版为噱头进行宣传**，示例仓库基于互联网公开接口封装，并**过滤掉所有 VIP、试听、付费歌曲**，且示例仓库以后也**不会提供具备破解功能的插件**； 72cc1e122S猫头猫> - 本软件的相关信息**只会主动投放在 Git 仓库以及公众号“一只猫头猫”中**，如果希望写文章介绍本软件请自便，但还烦请**如实陈述，涉及到示例仓库请给插件源打个码**，不要给软件增加一些不实的功能（尽管我也想有）；描述冲突的地方以本仓库为准。 88eb7504dS猫头猫> - **如果使用到本项目，请严格遵守 GPL 协议：必须开源且免费** 92cc1e122S猫头猫 10e55af177S猫头猫**打包分发请保留出处：https://github.com/maotoumao/MusicFree** 11e55af177S猫头猫 12cfa0fc07S猫头猫## 简介 132b80a429S猫头猫 14cfa0fc07S猫头猫一个插件化、定制化、无广告的免费音乐播放器，目前只支持 Android 和 Harmony OS。 15cfa0fc07S猫头猫 162b80a429S猫头猫> **桌面版来啦：<https://github.com/maotoumao/MusicFreeDesktop>** 173612f518S猫头猫 18*d66f7ec7S猫头猫如果需要了解后续进展可以关注公众号↓；如果有问题可以在 issue 区或者公众号直接留言反馈。 19756791fcS猫头猫 20654a485dS猫头猫 21654a485dS猫头猫 22*d66f7ec7S猫头猫软件下载方式、插件使用说明、插件开发文档可去站点 [https://musicfree.upup.fun](https://musicfree.upup.fun) 查看。 23*d66f7ec7S猫头猫 24cfa0fc07S猫头猫## 特性 252b80a429S猫头猫 26cfa0fc07S猫头猫- 插件化：本软件仅仅是一个播放器，本身**并不集成**任何平台的任何音源，所有的搜索、播放、歌单导入等功能全部基于**插件**。这也就意味着，**只要可以在互联网上搜索到的音源，只要有对应的插件，你都可以使用本软件进行搜索、播放等功能**。关于插件的详细说明请看插件一节。 27cfa0fc07S猫头猫 28cfa0fc07S猫头猫- 插件支持的功能：搜索（音乐、专辑、作者）、播放、查看专辑、查看作者详细信息、导入单曲、导入歌单、获取歌词等。 29cfa0fc07S猫头猫 30cfa0fc07S猫头猫- 定制化、无广告：本软件提供了浅色、深色模式；支持自定义背景；本软件基于 GPL 协议开源，~~一个 star 做交易~~ 将会保持免费。 31cfa0fc07S猫头猫- 隐私：所有的数据都存储在本地，本软件不会收集你的任何个人信息。 32cfa0fc07S猫头猫- 歌词关联：你可以把两首歌的歌词关联起来，比如将歌曲 A 的歌词关联到歌曲 B，关联后 A、B 两首歌都将显示歌曲 B 的歌词。你也可以关联多首歌的歌词，如 A->B->C，这样 A、B、C 三首歌都将显示 C 的歌词。 33cfa0fc07S猫头猫 34b74e4fd8S猫头猫## 插件 352b80a429S猫头猫 36b74e4fd8S猫头猫### 插件简介 372b80a429S猫头猫 38437c2a04S猫头猫插件本质上是一个满足插件协议的 commonjs 模块。插件中定义了搜索（音乐、专辑、作者）、播放、查看专辑、作者详细信息、导入歌单、获取歌词等基本函数，插件的开发者只需要关心输入输出逻辑，至于分页、缓存等全都交给 MusicFree 控制即可。本软件通过插件来完成播放器的所有功能，这样解耦的设计也可以使得本软件可以专注于做一个功能完善的播放器，我直呼小而美。 39b74e4fd8S猫头猫 40*d66f7ec7S猫头猫插件开发文档可以参考 [这里](https://musicfree.upup.fun/plugin/introduction.html) 41b74e4fd8S猫头猫 42b74e4fd8S猫头猫需要注意的是： 432b80a429S猫头猫 44b74e4fd8S猫头猫- 如果你是使用第三方下载的插件，那么请自行鉴别插件的安全性（基本上看下没有奇怪的网络请求什么的就好了；自己写的最安全，*不要安装来路不明的东西*），防止恶意代码破坏。因为第三方恶意插件导致的可能的损失与本软件无关。 45b74e4fd8S猫头猫 4674acbfc0S猫头猫- 插件使用过程中可能会产生某些和本软件无关的版权数据，插件、以及插件产生的任何数据与本软件无关，请使用者自行斟酌，及时删除数据，本软件不提倡也不会提供任何破解行为，你可以搭建自己的离线音乐仓库使用。 47b74e4fd8S猫头猫 48b74e4fd8S猫头猫### 插件使用 492b80a429S猫头猫 5074acbfc0S猫头猫下载 app 之后，只需要在侧边栏设置-插件设置中安装插件即可。支持安装本地插件和从网络安装插件（支持解析.js 文件和.json 描述文件；已经写了几个示意的插件：[指路这个仓库](https://github.com/maotoumao/MusicFreePlugins)，不过可能功能不是很完善）； 51*d66f7ec7S猫头猫 52*d66f7ec7S猫头猫 532b80a429S猫头猫你可以直接点击从网络安装插件，然后输入<https://gitee.com/maotoumao/MusicFreePlugins/raw/master/plugins.json> ，点击确认即可安装。 54b74e4fd8S猫头猫 55*d66f7ec7S猫头猫图文版详细使用说明可以参考公众号：[MusicFree 插件使用指南](https://mp.weixin.qq.com/s?__biz=MzkxOTM5MDI4MA==&mid=2247483875&idx=1&sn=aedf8bb909540634d927de7fd2b4b8b1&chksm=c1a390c4f6d419d233908bb781d418c6b9fd2ca82e9e93291e7c93b8ead3c50ca5ae39668212#rd)，或者站点： https://musicfree.upup.fun/usage/mobile/install-plugin.html 569af8256fS猫头猫 57b74e4fd8S猫头猫## 下载地址 582b80a429S猫头猫 59654a485dS猫头猫请转到发布页查看：[指路](https://github.com/maotoumao/MusicFree/releases) (如果打不开可以把 github 换成 gitee)，公众号回复 Musicfree 也可以。 60b74e4fd8S猫头猫 619af8256fS猫头猫## Q&A 622b80a429S猫头猫 63*d66f7ec7S猫头猫使用时遇到的常见问题可以看这里：[MusicFree 使用 Q&A](https://musicfree.upup.fun/qa/common.html) 64d38fca79S猫头猫 652b80a429S猫头猫技术交流/一起写点有意思的东西/技术向的闲聊欢迎加群：[683467814](https://jq.qq.com/?_wv=1027&k=upVpi2k3)~ （不是答疑群） 662369f63cS猫头猫 67*d66f7ec7S猫头猫闲聊可以到 [QQ 频道](https://pd.qq.com/s/cyxnf0jj1)~ 68*d66f7ec7S猫头猫 69ab6592f1S猫头猫## WIP 702b80a429S猫头猫 71*d66f7ec7S猫头猫如果有需要讨论的新需求，可以在公众号后台留言/提issue/或者去discussion开个话题。 72b74e4fd8S猫头猫 732369f63cS猫头猫## 支持这个项目 742b80a429S猫头猫 752369f63cS猫头猫如果你喜欢这个项目，或者希望我可以持续维护下去，你可以通过以下任何一种方式支持我;) 762b80a429S猫头猫 772369f63cS猫头猫1. Star 这个项目，分享给你身边的人； 78*d66f7ec7S猫头猫2. 关注公众号��或 b 站 [不想睡觉猫头猫](https://space.bilibili.com/12866223) 获取最新信息； 792369f63cS猫头猫 802369f63cS猫头猫 812369f63cS猫头猫 822369f63cS猫头猫感谢以下小伙伴的推荐，很意外也很惊喜 ~~~ 832369f63cS猫头猫 842b80a429S猫头猫来自**果核剥壳**的安利~ <https://mp.weixin.qq.com/s/F6hMbLv_a-Ty0fPA_0P0Rg> 852369f63cS猫头猫 862b80a429S猫头猫来自**小棉袄**的安利~ <https://mp.weixin.qq.com/s/Fqe3o7vcTw0KDKoB-gsQfg> 872369f63cS猫头猫 88b74e4fd8S猫头猫## ChangeLog 892b80a429S猫头猫 90253ef377S猫头猫[点击这里](./changelog.md) 91b74e4fd8S猫头猫 92b74e4fd8S猫头猫--- 93d38fca79S猫头猫本项目仅供学习参考使用，基于 GPL3.0 协议开源；请在符合法律法规的情况下合理使用本项目，禁止用于商业目的使用。 94b74e4fd8S猫头猫 955d19d26cS猫头猫## 应用截图 962b80a429S猫头猫 975d19d26cS猫头猫#### 主界面 982b80a429S猫头猫 995d19d26cS猫头猫 100cfa0fc07S猫头猫 1015d19d26cS猫头猫#### 侧边栏 1022b80a429S猫头猫 1035d19d26cS猫头猫- 基础设置 1045d19d26cS猫头猫 1055d19d26cS猫头猫 1065d19d26cS猫头猫- 插件设置 1075d19d26cS猫头猫 1085d19d26cS猫头猫 1095d19d26cS猫头猫- 主题设置 1105d19d26cS猫头猫 1115d19d26cS猫头猫 1125d19d26cS猫头猫#### 音乐相关 1132b80a429S猫头猫 1145d19d26cS猫头猫- 歌单页 1155d19d26cS猫头猫 1165d19d26cS猫头猫 1175d19d26cS猫头猫- 歌单内检索 1185d19d26cS猫头猫 1195d19d26cS猫头猫 1205d19d26cS猫头猫- 播放页 1215d19d26cS猫头猫 1225d19d26cS猫头猫 1235d19d26cS猫头猫- 歌词页 1245d19d26cS猫头猫 1255d19d26cS猫头猫 1265d19d26cS猫头猫- 播放列表页 1275d19d26cS猫头猫 1285d19d26cS猫头猫 1295d19d26cS猫头猫#### 搜索相关 1302b80a429S猫头猫 1315d19d26cS猫头猫- 搜索单曲 1325d19d26cS猫头猫 1335d19d26cS猫头猫 1345d19d26cS猫头猫- 搜索专辑 1355d19d26cS猫头猫 1365d19d26cS猫头猫 1375d19d26cS猫头猫- 专辑信息 1385d19d26cS猫头猫 1395d19d26cS猫头猫 1405d19d26cS猫头猫- 搜索作者 1415d19d26cS猫头猫 1425d19d26cS猫头猫 1435d19d26cS猫头猫- 作者信息 1445d19d26cS猫头猫 145
