readme.md (5c3b46ec4371e0c8ecc5ed0f89cb5a08a8d3bd98) readme.md (b74e4fd829465b2e0c04dbaf29c2562cf5924fa4)
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
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![主界面](./.imgs/main.jpg)
20
21#### 侧边栏
22- 基础设置
23![基础设置](./.imgs/basic-setting.jpg)
24
25- 插件设置
26![插件设置](./.imgs/plugin-setting.jpg)
27
28- 主题设置
29![主题设置](./.imgs/theme-setting.jpg)
30
31#### 音乐相关
32- 歌单页
33![歌单页](./.imgs/song-sheet.jpg)
34
35- 歌单内检索
36![歌单内检索](./.imgs/search-in-sheet.jpg)
37
38- 播放页
39![播放页](./.imgs/song-cover.jpg)
40
41- 歌词页
42![歌词页](./.imgs/song-lrc.jpg)
43
44- 播放列表页
45![播放列表页](./.imgs/play-list.jpg)
46
47#### 搜索相关
48- 搜索单曲
49![搜索单曲](./.imgs/search.jpg)
50
51- 搜索专辑
52![搜索专辑](./.imgs/search-album.jpg)
53
54- 专辑信息
55![专辑信息](./.imgs/album-detail.jpg)
56
57- 搜索作者
58![搜索作者](./.imgs/search-artist.jpg)
59
60- 作者信息
61![专辑信息](./.imgs/artist-detail.jpg)
62
63
64## 插件
65### 插件简介
17## 插件
18### 插件简介
66插件本质上是一个满足插件协议的js函数。插件中定义了搜索(音乐、专辑、作者)、播放、查看专辑、作者详细信息、导入歌单、获取歌词等基本函数,插件的开发者只需要关心输入输出逻辑,至于分页、缓存等全都交给MusicFree控制即可。本软件通过插件来完成播放器的所有功能,这样解耦的设计也可以使得本软件可以专注于做一个功能完善的播放器,我直呼小而美。
19插件本质上是一个满足插件协议的js函数。插件中定义了搜索(音乐、专辑、作者)、播放、查看专辑、作者详细信息、导入歌单、获取歌词等基本函数,插件的开发者只需要关心输入输出逻辑,至于分页、缓存等全都交给MusicFree控制即可。本软件通过插件来完成播放器的所有功能,这样解耦的设计也可以使得本软件可以专注于做一个功能完善的播放器,我直呼小而美。
67
68插件开发文档可以参考 [这里](http://blog.upup.fun/2022/09/15/%E5%BC%80%E5%8F%91MusicFree%E6%8F%92%E4%BB%B6/) (写的很简略....真的有人需要的时候再详细写吧..)
69
70
71需要注意的是:
72- 如果你是使用第三方下载的插件,那么请自行鉴别插件的安全性(基本上看下没有奇怪的网络请求什么的就好了;自己写的最安全,*不要安装来路不明的东西*),防止恶意代码破坏。因为第三方恶意插件导致的可能的损失与本软件无关。
73
74- 插件使用过程中可能会产生某些和本软件无关的版权数据,插件产生的任何数据与本软件无关,请使用者自行删除数据。
75
76### 插件使用
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### 插件使用
77下载app之后,只需要在侧边栏设置-插件设置中安装插件即可。支持安装本地插件和从网络安装插件(支持解析.js文件和.json描述文件;已经写了几个示意的插件:[指路](https://github.com/maotoumao/MusicFreePlugins),不过可能功能还不是很完善);
30下载app之后,只需要在侧边栏设置-插件设置中安装插件即可。支持安装本地插件和从网络安装插件(支持解析.js文件和.json描述文件;已经写了几个示意的插件:[指路这个仓库](https://github.com/maotoumao/MusicFreePlugins),不过可能功能还不是很完善);
78你可以直接点击从网络安装插件,然后输入https://gitee.com/maotoumao/MusicFreePlugins/raw/master/plugins.json,点击确认即可安装。
79
80## 下载地址
81请转到发布页查看:[指路](https://github.com/maotoumao/MusicFree/releases) (如果打不开可以把github换成gitee)
82
83
84## ChangeLog
85`2022.10.06 v0.0.1-alpha.4`

--- 18 unchanged lines hidden (view full) ---

104## 支持这个项目
105如果你喜欢这个项目,或者希望我可以持续维护下去,你可以通过以下任何一种方式支持我;)
1061. Star这个项目,分享给你身边的人;
1072. 关注b站[不想睡觉猫头猫](https://space.bilibili.com/12866223)或公众号获取最新信息;
108
109
110---
111本项目仅供学习参考使用,不得以任何方式用于任何商业行为;请在符合法律法规的情况下合理使用本项目。
31你可以直接点击从网络安装插件,然后输入https://gitee.com/maotoumao/MusicFreePlugins/raw/master/plugins.json,点击确认即可安装。
32
33## 下载地址
34请转到发布页查看:[指路](https://github.com/maotoumao/MusicFree/releases) (如果打不开可以把github换成gitee)
35
36
37## ChangeLog
38`2022.10.06 v0.0.1-alpha.4`

--- 18 unchanged lines hidden (view full) ---

57## 支持这个项目
58如果你喜欢这个项目,或者希望我可以持续维护下去,你可以通过以下任何一种方式支持我;)
591. Star这个项目,分享给你身边的人;
602. 关注b站[不想睡觉猫头猫](https://space.bilibili.com/12866223)或公众号获取最新信息;
61
62
63---
64本项目仅供学习参考使用,不得以任何方式用于任何商业行为;请在符合法律法规的情况下合理使用本项目。
65
66
67## 应用截图
68#### 主界面
69![主界面](./.imgs/main.jpg)
70
71#### 侧边栏
72- 基础设置
73![基础设置](./.imgs/basic-setting.jpg)
74
75- 插件设置
76![插件设置](./.imgs/plugin-setting.jpg)
77
78- 主题设置
79![主题设置](./.imgs/theme-setting.jpg)
80
81#### 音乐相关
82- 歌单页
83![歌单页](./.imgs/song-sheet.jpg)
84
85- 歌单内检索
86![歌单内检索](./.imgs/search-in-sheet.jpg)
87
88- 播放页
89![播放页](./.imgs/song-cover.jpg)
90
91- 歌词页
92![歌词页](./.imgs/song-lrc.jpg)
93
94- 播放列表页
95![播放列表页](./.imgs/play-list.jpg)
96
97#### 搜索相关
98- 搜索单曲
99![搜索单曲](./.imgs/search.jpg)
100
101- 搜索专辑
102![搜索专辑](./.imgs/search-album.jpg)
103
104- 专辑信息
105![专辑信息](./.imgs/album-detail.jpg)
106
107- 搜索作者
108![搜索作者](./.imgs/search-artist.jpg)
109
110- 作者信息
111![专辑信息](./.imgs/artist-detail.jpg)