MusicFree手机版

MusicFree音乐播放器用起来更加的个性化，您可以自由的添加各种js插件，使得您的播放器变得更加强大，作者默认就制作了很多插件，您可以参考下方的教程进行安装！

MusicFree官方简介

一个插件化、定制化、无广告的免费音乐播放器，目前只支持Android和Harmony OS。

MusicFree安卓客户端特色

插件化：本软件仅仅是一个播放器，本身并不集成任何平台的任何音源，所有的搜索、播放、歌单导入等功能全部基于插件。这也就意味着，只要可以在互联网上搜索到的音源，只要有对应的插件，你都可以使用本软件进行搜索、播放等功能。关于插件的详细说明请看插件一节。

歌词关联：你可以把两首歌的歌词关联起来，比如将歌曲A的歌词关联到歌曲B，关联后A、B两首歌都将显示歌曲B的歌词。你也可以关联多首歌的歌词，如A->B->C，这样A、B、C三首歌都将显示C的歌词。

定制化、无广告：本软件提供了浅色、深色模式；支持自定义背景；本软件基于GPL协议开源，一个star做交易 将会保持免费。

插件支持的功能：搜索（音乐、专辑、作者）、播放、查看专辑、查看作者详细信息、导入单曲、导入歌单、获取歌词等。

隐私：所有的数据都存储在本地，本软件不会收集你的任何个人信息。

插件使用教程

下载app之后，只需要在侧边栏设置-插件设置中安装插件即可。支持安装本地插件和从网络安装插件（支持解析。js文件和。json描述文件；已经写了几个示意的插件：指路这个仓库，不过可能功能不是很完善）； 你可以直接点击从网络安装插件，然后输入MusicFree音乐源https://gitee.com/maotoumao/MusicFreePlugins/raw/master/plugins.json ，点击确认即可安装。

常见问题

遇到“播放一首歌就停止”的情况？

检查一下系统设置中 “后台运行” 权限是否打开；如果是未授予权限，打开权限后重启app应该就好了

音乐下载路径在哪里？

Android/data/fun.upup.musicfree/files/download/music

本地音乐导入之后为空？

1. 可能没有给读取存储的权限

2. 目前导入本地音乐只支持mp3格式

歌曲id是什么？

点击歌曲详情按钮，拉起歌曲详情浮层，第一行就是歌曲id，点击即可复制。

插件怎么找？

目前已有的插件都是自己写的，可以参考这个仓库：

https://github.com/maotoumao/MusicFreePlugins；你也可以按照插件开发文档（待补充）自行开发任意源的插件。

插件能不能搜索VIP音乐 / 支持xxx软件？

上述仓库下的插件为示例插件，本质上只是基于网络公开的接口做的封装；没有任何VIP破解/收费音乐破解/软件解包的功能，并且会过滤掉VIP/仅供试听的音乐。以后也不会提供破解相关功能。

为什么插件只有部分源有导入功能？

插件没写完整，后续补充完整之后直接在侧边栏更新即可。

为什么导入某源的歌单后，提示“目标歌单为空”？

1. 部分源的默认歌单不支持导入，可以先复制到新歌单，再导入新歌单即可；

2. 导入时有一些隐含规则，歌单URL满足特定正则时可以正常导入（后续完善插件规则就好了）；如果遇到这种情况，可以升级对应软件的客户端版本尝试一下

选择音质、导入无损音乐？

导入无损音乐暂时有点问题，在改了在改了。音质相关，会尽快完善插件协议。

是否收费/有收费计划？

开源项目，仅供学习参考使用，始终会保持免费。请不要用于任何商业用途，使用过程中可能产生的版权数据与app无关，请及时自行删除。

更新日志

v0.2.1

【功能】支持webdav备份&播放

【功能】插件榜单详情支持分页

【功能】插件支持显示作者

【功能】侧边栏新增“权限管理”设置

【功能】首页&歌词页样式改版：新增歌词进度调整、歌词大小调整、歌词翻译、自动搜索歌词

【功能】新增收藏歌单功能

【功能】音乐播放栏支持左右滑动切歌（可能会闪一下，后续修掉）

【功能】新增“通知栏显示关闭按钮”设置

【优化】统一浮层、toast样式

【优化】重构播放、数据存储逻辑

【优化】去除插件url必须以.js结尾的限制

【修复】修改无限列表到底不触发onendreached的问题(感谢@282931)

【修复】修复播放记录退出后被清空的问题

【修复】修复标题栏背景色透明度不生效的问题

【修复】修复部分情况下深色模式异常的问题

v0.1.2

【功能】新增桌面歌词功能，可在设置页开启（开启之前需要去手机设置授予悬浮窗权限）

【功能】新增插件设置：打开软件时自动更新插件、安装插件时不校验版本

【功能】新增播放设置：打开软件时自动播放歌曲

【功能】可以使用musicfree打开本地.js或.mp3文件；其中.js文件会被当作插件安装；.mp3文件会直接播放

【功能】插件页新增开关，可以控制是否在榜单、热门歌单、搜索结果中展示对应插件的结果

【功能】插件协议新增“用户变量”，可以在插件中获取app输入的配置（可以由此实现自建音乐源的插件/webdav源插件，但是还没写）

【优化】下载单曲支持选择音质

【优化】侧边栏新增“返回桌面”按钮

【优化】新增“关联歌词方式”设置，如果设置为“输入歌曲id”，则会恢复老版本关联歌词，即输入id关联歌词

【修复】修复榜单、推荐歌单、搜索歌词页白屏闪退的问题(感谢@282931)

【修复】修复自定义背景模糊度和透明度无法设置为0的问题(感谢@282931)

【修复】修复无法恢复桌面版导出的歌单的问题

【修复】修复浅色主题状态栏表现错误的问题

【修复】修复歌单批量编辑无法删除的问题

v0.1.0-alpha.1

【功能】插件更新，升级到新版本之后原有插件完全不兼容；更新后卸载原有插件，然后更新订阅即可（具体看公众号示例）

【功能】重写了插件订阅的逻辑，现在应该会更合理一点点

【功能】删除本地文件之前增加二次确认提醒

【功能】新增功能“倍速播放”

【功能】增加了一些无关紧要的分享

【样式】换了个logo，丑的更直白一些

【样式】专辑描述文字默认6行，点击可以展开或折叠

【样式】调整了一些样式（如播放页的模糊和透明度、歌词样式等）

【修复】修复部分情况下无法下载的问题

【插件】大量插件有更新，更新到此版本后更新订阅即可