MusicFree是一款专为音乐爱好者打造的开源插件化音乐播放工具，其核心优势在于彻底去除广告干扰，营造纯净、专注的听歌体验。在主流音乐平台普遍依赖广告和会员体系盈利的当下，MusicFree通过技术手段屏蔽所有形式的广告内容，让用户回归音乐本身，享受无打扰的流畅播放环境。

插件安装指南

如何导入插件

插件配置地址：https://gitee.com/maotoumao/MusicFree/raw/master/plugins.json

1. 打开MusicFree应用，点击左上角【菜单栏】进入主菜单；
2. 在弹出的功能列表中，选择【插件设置】进入管理界面；

3. 在插件设置页面，点击右下角多选按钮，在弹出选项中按需选择【从本地/网络安装插件】；
4. 若选择网络安装，直接粘贴上述URL并确认，系统将自动加载插件列表，完成后即可畅听各类音乐资源。

常见问题解答

播放一首歌后自动停止？

请检查系统设置中是否已授予应用“后台运行”权限。若未开启，请手动启用后重启应用。

音乐下载路径在哪？

默认保存路径为：Android/data/fun.upup.musicfree/files/download/music

导入本地音乐后显示为空？

1. 确认是否已授予应用“读取存储”权限；
2. 当前仅支持导入MP3格式的本地音频文件。

如何获取歌曲ID？

点击歌曲详情按钮，弹出浮层后，第一行即为歌曲ID，点击即可复制。

插件从哪里获取？

官方插件均由开发者自行编写，可参考仓库：https://github.com/maotoumao/MusicFreePlugins。用户也可依据插件开发文档（后续补充）自行开发适配任意音乐源的插件。

是否支持搜索VIP音乐或破解其他平台内容？

所有插件仅为对公开网络接口的封装，不包含任何VIP破解、收费音乐绕过或软件解包功能，且会主动过滤VIP专享或仅限试听的曲目。未来亦不会提供相关破解能力。

为何部分插件缺少导入功能？

因插件尚未开发完整，后续更新后可在侧边栏直接同步最新版本。

导入歌单提示“目标歌单为空”？

1. 部分音乐源的默认歌单不支持直接导入，建议先复制至新建歌单后再尝试导入；
2. 导入功能依赖特定URL正则规则匹配，若失败可尝试升级对应客户端版本以获得兼容性修复。

能否选择音质或导入无损音乐？

无损音乐导入功能目前存在兼容性问题，正在修复中；音质选择相关协议也将尽快完善。

是否收费或有付费计划？

本项目为开源免费软件，始终免费且仅供学习交流使用，严禁用于商业用途。使用过程中涉及的版权内容与本应用无关，请用户自行及时删除。

核心功能特色

1. 内置由社区用户整理的高质量原唱音乐专辑，支持一键播放、加入个人歌单及免费下载，操作便捷高效。

2. 应用体积轻量、界面简洁，无冗余模块，既可作为日常音乐播放器，也能胜任多源音乐资源搜索任务。

3. 针对用户常面临的“免费音乐难寻”痛点，提供合法合规的聚合收听方案，降低优质音乐获取门槛。

独特体验亮点

1. 离线搜歌：支持无网络状态下录音搜歌，音频将自动暂存，联网后自动上传识别；

2. 智能推荐：基于算法精准推送与当前歌曲风格相近的作品及歌手，助力发现更多心动旋律；

3. 哼唱识别：内置音乐识别引擎，只需哼唱片段旋律，即可快速定位目标歌曲。