1# MusicFree 2--- 3## 简介 4一个插件化、定制化、无广告的免费音乐播放器，目前只支持Android和Harmony OS。 5 6如果需要了解后续进展可以关注b站账号：[不想睡觉猫头猫](https://space.bilibili.com/12866223)；如果有问题可以在issue区或者qq群：[252994941](https://jq.qq.com/?_wv=1027&k=igip9n4T)反馈。 7 8## 特性 9- 插件化：本软件仅仅是一个播放器，本身**并不集成**任何平台的任何音源，所有的搜索、播放、歌单导入等功能全部基于**插件**。这也就意味着，**只要可以在互联网上搜索到的音源，只要有对应的插件，你都可以使用本软件进行搜索、播放等功能**。关于插件的详细说明请看插件一节。 10 11- 插件支持的功能：搜索（音乐、专辑、作者）、播放、查看专辑、查看作者详细信息、导入单曲、导入歌单、获取歌词等。 12 13- 定制化、无广告：本软件提供了浅色、深色模式；支持自定义背景；本软件基于GPL协议开源，~~一个star做交易~~ 将会保持免费。 14- 隐私：所有的数据都存储在本地，本软件不会收集你的任何个人信息。 15- 歌词关联：你可以把两首歌的歌词关联起来，比如将歌曲A的歌词关联到歌曲B，关联后A、B两首歌都将显示歌曲B的歌词。你也可以关联多首歌的歌词，如A->B->C，这样A、B、C三首歌都将显示C的歌词。 16 17## 插件 18### 插件简介 19插件本质上是一个满足插件协议的js函数。插件中定义了搜索（音乐、专辑、作者）、播放、查看专辑、作者详细信息、导入歌单、获取歌词等基本函数，插件的开发者只需要关心输入输出逻辑，至于分页、缓存等全都交给MusicFree控制即可。本软件通过插件来完成播放器的所有功能，这样解耦的设计也可以使得本软件可以专注于做一个功能完善的播放器，我直呼小而美。 20 21插件开发文档可以参考 [这里](http://blog.upup.fun/2022/09/15/%E5%BC%80%E5%8F%91MusicFree%E6%8F%92%E4%BB%B6/) (写的很简略....真的有人需要的时候再详细写吧..) 22 23 24需要注意的是： 25- 如果你是使用第三方下载的插件，那么请自行鉴别插件的安全性（基本上看下没有奇怪的网络请求什么的就好了；自己写的最安全，*不要安装来路不明的东西*），防止恶意代码破坏。因为第三方恶意插件导致的可能的损失与本软件无关。 26 27- 插件使用过程中可能会产生某些和本软件无关的版权数据，插件产生的任何数据与本软件无关，请使用者自行删除数据。 28 29### 插件使用 30下载app之后，只需要在侧边栏设置-插件设置中安装插件即可。支持安装本地插件和从网络安装插件（支持解析.js文件和.json描述文件；已经写了几个示意的插件：[指路这个仓库](https://github.com/maotoumao/MusicFreePlugins)，不过可能功能还不是很完善）； 31你可以直接点击从网络安装插件，然后输入https://gitee.com/maotoumao/MusicFreePlugins/raw/master/plugins.json，点击确认即可安装。 32 33## 下载地址 34请转到发布页查看：[指路](https://github.com/maotoumao/MusicFree/releases) (如果打不开可以把github换成gitee) 35 36## WIP 371. 歌曲批量编辑 [0%] 382. 横屏适配 [0%] 39 40## ChangeLog 41`2022.10.16 v0.0.1-alpha.5` 421. 新增功能：导入本地音乐文件 432. 从网络源安装的插件可在插件页直接更新 443. 调整下载逻辑 45 46`2022.10.06 v0.0.1-alpha.4` 471. 修复专辑详情页没有loading的问题 482. 为插件新增Cookie管理器 493. 优化播放页的显示 504. 新增一键卸载全部插件的功能 51 52`2022.10.04 v0.0.1-alpha.3` 531. 修复设置页无法滚动的问题 542. 修复播放结束时可能暂停的问题 55 56`2022.10.03 v0.0.1-alpha.2` 571. 插件协议更新，需要重新安装插件 582. 支持批量导入插件 593. 新增清空播放列表功能 604. 优化搜索结果面板和播放专辑逻辑 61 62`2022.10.02` 63测试版本出现啦！撒花 64 65## 支持这个项目 66如果你喜欢这个项目，或者希望我可以持续维护下去，你可以通过以下任何一种方式支持我;) 671. Star这个项目，分享给你身边的人； 682. 关注b站[不想睡觉猫头猫](https://space.bilibili.com/12866223)或公众号获取最新信息； 69 70 71--- 72本项目仅供学习参考使用，使用请遵从GPL3.0协议；请在符合法律法规的情况下合理使用本项目。 73 74 75## 应用截图 76#### 主界面 77 78 79#### 侧边栏 80- 基础设置 81 82 83- 插件设置 84 85 86- 主题设置 87 88 89#### 音乐相关 90- 歌单页 91 92 93- 歌单内检索 94 95 96- 播放页 97 98 99- 歌词页 100 101 102- 播放列表页 103 104 105#### 搜索相关 106- 搜索单曲 107 108 109- 搜索专辑 110 111 112- 专辑信息 113 114 115- 搜索作者 116 117 118- 作者信息 119 120
