手机版APP界面
桌面版界面
特性
插件化:本软件仅仅是一个播放器,本身并不集成任何平台的任何音源,所有的搜索、播放、歌单导入等功能全部基于插件。这也就意味着,只要可以在互联网上搜索到的音源,只要有对应的插件,你都可以使用本软件进行搜索、播放等功能。关于插件的详细说明请看插件一节。
插件支持的功能:搜索(音乐、专辑、作者)、播放、查看专辑、查看作者详细信息、导入单曲、导入歌单、获取歌词等。
定制化、无广告:本软件提供了浅色、深色模式;支持自定义背景;本软件基于 AGPL 协议开源,一个 star 做交易 将会保持免费。
隐私:所有的数据都存储在本地,本软件不会收集你的任何个人信息。
歌词关联:你可以把两首歌的歌词关联起来,比如将歌曲 A 的歌词关联到歌曲 B,关联后 A、B 两首歌都将显示歌曲 B 的歌词。你也可以关联多首歌的歌词,如 A->B->C,这样 A、B、C 三首歌都将显示 C 的歌词。
插件
插件简介
插件本质上是一个满足插件协议的 commonjs 模块。插件中定义了搜索(音乐、专辑、作者)、播放、查看专辑、作者详细信息、导入歌单、获取歌词等基本函数,插件的开发者只需要关心输入输出逻辑,至于分页、缓存等全都交给 MusicFree 控制即可。本软件通过插件来完成播放器的所有功能,这样解耦的设计也可以使得本软件可以专注于做一个功能完善的播放器,我直呼小而美。
需要注意的是:
如果你是使用第三方下载的插件,那么请自行鉴别插件的安全性(基本上看下没有奇怪的网络请求什么的就好了;自己写的最安全,不要安装来路不明的东西),防止恶意代码破坏。因为第三方恶意插件导致的可能的损失与本软件无关。
插件使用过程中可能会产生某些和本软件无关的版权数据,插件、以及插件产生的任何数据与本软件无关,请使用者自行斟酌,及时删除数据,本软件不提倡也不会提供任何破解行为,你可以搭建自己的离线音乐仓库使用。
为什么搜不到 XXX 歌,能不能支持 VIP
软件本身没有 VIP 的概念。搜索功能和软件无关,和具体插件实现有关。如果你使用的是示例插件,请参考 示例插件的声明。
插件只是示例,来自于网络公开的接口,并过滤掉所有 VIP/收费/试听歌曲。仅供学习参考使用,请不要用于任何商业用途,合理合法使用。
以后示例插件仓库也没有任何类似 “破解” 行为的打算。
为什么某首歌无法播放/只能播放一部分
大概率是插件的问题,需要找对应插件的作者修复插件。
原因同上,但:
如果是移动端后台运行时播完一首歌就停,先确认下是否在系统设置中把允许后台运行打开。
如果是遇到某首歌就暂停,可能是因为这首歌失效了,并且设置中打开了“播放失败时自动暂停”
如果非以上原因无法播放,可能是因为这首歌的音源链接是个死链,这种情况下会自动暂停。
如果是一首歌只能播放一部分,那八成这首歌是个 VIP 试听歌曲,插件没过滤干净。
如果是偶尔只能播放一小部分,可能是因为插件返回的音源链接有失效时间,重新播放一下就好了。
为什么不同音质的歌曲听起来没区别 / 无法切换音质
原因基本同上,是否拥有不同音质的音乐由插件决定。软件内会根据设置,在某个音质缺失时,自动用更高或更低音质代替。
软件能不能支持 XXX 音质
上面解释过,是否拥有不同音质的音乐由插件决定。软件预先定义了 4 种音质,但具体支持哪种音质,由插件决定。
为什么插件安装失败
如果是从网络安装插件,需要注意:输入的内容是 结尾是 .json 或者 .js 的链接,不是奇奇怪怪的 json。
如果确定输入的是正确的 URL,且 URL 指向的是 MusicFree 的插件,可能是由于网络错误,过一会再试试,或者下载下来然后安装本地插件。
下载文件是否能修改文件名?
下载文件名暂时不能改,因为歌曲信息没写在文件中,暂时是靠歌名来区分的,所以命名才这么奇怪。。
MusicFree 是否有收费/添加广告的计划
现在没有,以后也没有。
安卓版常见问题
文件的下载路径在哪里
默认路径:Android/data/fun.upup.musicfree/files/download/music,可以在侧边栏修改。
无法后台播放 / 播放一首就暂停
检查一下系统设置中 “后台运行” 权限是否打开;如果是未授予权限,打开权限后重启 app 应该就好了
下载失败
请检查系统权限是否授予完整的 存储权限。
PC版常见问题
Win7/8/8.1 报错:无法找到入口
最新版的 electron 已经不支持 win7/8/8.1,所以特意单独针对这部分操作系统降版本打的包,不确保体验。
安装链接中的 ...-legacy-setup.exe 即适用于 win7/8/8.1 的安装包。
DANGER
win10/11 可以安装任意一个 setup.exe,但最好安装不带legacy标记的,体验可能会好一点。
另外,两个版本不要串着装,不然可能会丢数据。
主题包怎么装
新版本已经内置了主题市场,直接在主题市场里选择安装即可。
如何批量操作歌曲
在歌单内,按住 shift 操作歌曲,然后右键操作即可。也可以按 Ctrl + A 全选后右键操作。
Mac M芯片 提示文件已损坏
安装软件后打开控制台,输入:
xattr -r -d com.apple.quarantine /Applications/MusicFree.app
回车,即可正常使用软件。
v0.5.1 (2025.4.4)
【修复】修复插件开关点击无效的问题
【修复】修复开屏图片消失的问题
【优化】增加新建歌单名称的长度限制
【优化】优化插件安装失败的提示样式
v0.5.0 (2025.2.9)
【升级】升级ReactNative到0.76.5(注意:升级后只支持安卓7.0及以上设备,低于此版本的设备请不要升级)
【修复】修复了运行应用一段时间后容易闪退的问题
【修复】修复了插件网络请求无法传递cookie的问题
【修复】新增了设置本地歌单封面的功能(在0.4版本暂时下线了)
【修复】修复了部分情况下,播放本地音乐提示 “当前非Wifi环境” 的问题
【优化】优化了一些代码逻辑
v0.4.4 (2024.11.10)
【修复】修复了部分系统上弹窗、浮层等无法出现,或动画表现异常的问题
v0.4.3 (2024.10.27)
【修复】修复了部分系统上文字显示不全的问题
v0.4.2 (2024.9.18)
【修复】修复本地音乐无法播放的问题
v0.4.1 (2024.9.8)
【修复】修复桌面歌词无法开启的问题
【修复】修复了修改桌面歌词颜色会导致闪退的问题
【修复】回滚了本地音乐部分读取文件的逻辑
【修复】修复了点击【编辑歌单信息】按钮无效的问题
v0.4.0 (2024.9.1)
【升级】ReactNative升级到0.74.4
【功能】换了个logo和开屏页
【功能】播放列表的歌曲限制从1500首调整到10000首
【功能】重写了歌曲排序机制
【功能】插件新增评论区功能(需要插件实现getMusicComments方法)
【优化】调整部分样式,优化删除歌曲时的性能
【修复】修复歌词翻译错位的问题
【修复】修复部分情况下无法复制作者/专辑的问题
【修复】修复在歌单详情页删除歌单会导致白屏的问题
【修复】修复搜索框在部分情况下自动触发搜索的问题
【修复】修复右上角菜单位置跳变的问题
【修复】修复在预览专辑封面时触发返回不会关闭预览弹窗的问题
【修复】下载文件时转移文件中的保留字符(感谢@GuGuMur)
【其他】分架构打包,更新开源协议为 AGPL 3.0
v0.3.0 (2024.3.31)
【功能】历史播放记录支持批量编辑
【功能】歌单内支持按照加入时间排序
【功能】新增设置“本地歌单添加歌曲顺序”,在歌单内添加歌曲时可以加到歌单开头
【功能】首页新建歌单旁边新增“导入歌单”按钮,点击时会自动寻找具有导入歌单功能的插件,并拉起导入浮层
【功能】设置项中新增“自动换源”功能,当插件失效/无法获取播放链接时,会自动尝试更换其他源的同名歌曲
【优化】尝试优化了软件启动时间,应该有点作用
【优化】更新了存储方式,现在单个歌单可以存储大于10000首歌曲;
【优化】调整未开启“允许使用移动网络播放”开关时的样式表现
【优化】优化了设置页的样式
【优化】微调歌词详情页的布局
【修复】修复打开弹窗时,点击返回按钮不关闭弹窗的问题
【修复】修复启动软件时播放模式错误的问题
【修复】修复搜索结果页特定情况下白屏的问题
v0.2.0 (2024.1.21)
【功能】支持 Webdav 备份 & 播放
【功能】插件支持显示作者
【功能】插件榜单详情支持分页
【功能】首页&歌词页样式改版:新增歌词进度调整、歌词大小调整、歌词翻译、自动搜索歌词
【功能】新增收藏歌单功能
【功能】侧边栏新增“权限管理”设置
【功能】音乐播放栏支持左右滑动切歌(可能会闪一下,后续修掉)
【功能】新增 “通知栏显示关闭按钮” 设置
【优化】重构播放、数据存储逻辑
【优化】统一浮层、toast样式
【优化】去除插件URL必须以.js结尾的限制
【修复】修改无限列表到底不触发onEndReached的问题 (感谢 @282931)
【修复】修复标题栏背景色透明度不生效的问题
【修复】修复播放记录退出后被清空的问题
【修复】修复部分情况下深色模式异常的问题
v0.1.2-alpha.0 (2023.11.24)
【功能】新增桌面歌词功能,可在设置页开启(开启之前需要去手机设置授予悬浮窗权限)
【功能】可以使用 MusicFree 打开本地 .js 或 .mp3 文件;其中 .js 文件会被当作插件安装; .mp3 文件会直接播放
【功能】新增插件设置:打开软件时自动更新插件、安装插件时不校验版本
【功能】新增播放设置:打开软件时自动播放歌曲
【功能】插件页新增开关,可以控制是否在榜单、热门歌单、搜索结果中展示对应插件的结果
【功能】插件协议新增 “用户变量” ,可以在插件中获取 APP 输入的配置(可以由此实现自建音乐源的插件/webdav源插件,但是还没写)
【优化】下载单曲支持选择音质
【优化】新增“关联歌词方式”设置,如果设置为“输入歌曲ID”,则会恢复老版本关联歌词,即输入ID关联歌词
【优化】侧边栏新增“返回桌面”按钮
【修复】修复榜单、推荐歌单、搜索歌词页白屏闪退的问题 (感谢 @282931)
【修复】修复自定义背景模糊度和透明度无法设置为 0 的问题 (感谢 @282931)
【修复】修复浅色主题状态栏表现错误的问题
【修复】修复歌单批量编辑无法删除的问题
【修复】修复无法恢复桌面版导出的歌单的问题
v0.1.1-alpha.0 (2023.10.15)
【功能】音源支持m3u8 (桌面版下个版本支持m3u8)
【功能】增加歌曲详情页屏幕常亮的设置
【功能】重构主题相关功能,增加「跟随系统深色设置」选项;调整大部分样式,移除第三方UI库
【功能】插件页增加「插件批量更新」的功能
【功能】取消原「歌词关联」的逻辑,修改为拉起「歌词搜索」浮层
【优化】增加了一些无障碍属性
【修复】修复部分场景下无法保存歌单的问题
【修复】修复部分场景下重启之后无法播放歌曲的问题
【插件】部分插件更新,侧边栏更新插件即可
v0.1.0-alpha.10 (2023.8.13)
【功能】当前音乐无歌词时可以在歌词页搜索歌词
【优化】调整右上角弹出气泡的位置
【优化】增加打开歌曲详情页时的默认表现设置
【优化】修复进入歌词页时候显示跳变的问题
【插件】插件协议更新,更新后可以配置某插件不出现在特定的搜索结果页下
【插件】部分插件更新,侧边栏更新插件即可
v0.1.0-alpha.9 (2023.6.26)
【功能】新增搜索歌单功能
【功能】新增播放记录功能
【优化】加了一些无障碍适配
【插件】部分插件更新,侧边栏更新插件即可
v0.1.0-alpha.8 (2023.6.4)
【功能】新增“推荐歌单”功能,需要配合支持该功能的插件使用
【功能】导入本地文件时增加“全选”按钮
【优化】修改“保存专辑封面”时的提示文案
【修复】修复当目标歌曲在播放列表内时,添加到下一首播放无效的问题
【插件】部分插件更新,侧边栏更新插件即可
v0.1.0-alpha.7 (2023.5.21)
【功能】歌单页新增“播放全部”按钮
【功能】歌曲播放页中,长按专辑封面可保存到本地
【功能】歌单页新增“歌单排序”功能
【插件】b站插件作者页API变动,侧边栏更新插件即可
v0.1.0-alpha.6 (2023.5.3)
【功能】歌单内搜索时支持英文大小写模糊搜索
【修复】修复首次进入时歌曲可能无法正常播放的问题
v0.1.0-alpha.5 (2023.3.26)
【功能】更新弹窗新增“跳过此版本”的复选框
【功能】侧边栏-基本设置-开发选项中新增“查看错误日志”的选项,点击会弹出错误日志的弹窗
【修复】修复输入框被软键盘遮挡的问题
【优化】优化了定时关闭的样式
v0.1.0-alpha.4 (2023.3.19)
【功能】适配横屏设备
【功能】新建歌单时添加默认歌单名;从专辑/榜单批量添加到新歌单时,默认以专辑名/榜单名为新歌单名
【修复】修复设备有虚拟按键时,浮层会被遮挡的问题
【修复】修复拖拽歌词时部分情况下时间异常的问题
【修复】调整下载失败时的提示文案
【插件】部分插件有更新,可以从侧边栏更新
v0.1.0-alpha.3 (2023.2.26)
【功能】专辑列表支持分页,需要配合插件更新;
【优化】去掉了全面屏手机界面下方的小白条;
【优化】调整拖拽歌词时标识线的对齐范围;调整歌词拖到最底端时的逻辑;
【优化】调整下载歌曲时的文件名;
【优化】导入歌曲时的提示文案增加滚动;
【修复】修复特殊情况下歌曲中断后可能恢复到错误状态的问题(未验证);
【插件】个别插件有更新,可以去侧边栏更新订阅。
v0.1.0-alpha.2 (2023.2.13)
【功能】备份&恢复:可以把本地的歌单和插件备份到一个json文件中,也可以从本地文件或网络上恢复插件和歌单。
【修复】修复部分情况下后台播放切换歌曲时暂停的问题
【修复】修复部分场景无法下载的问题
【修复】修复部分场景无法删除本地文件的问题
【优化】简单优化了下歌单列表
【调试】调试面板现在可以打印出插件中的console语句
v0.1.0-alpha.1 (2023.1.27)
【功能】插件更新,升级到新版本之后原有插件完全不兼容;更新后卸载原有插件,然后更新订阅即可(具体看公众号示例)
【功能】新增功能“倍速播放”
【功能】重写了插件订阅的逻辑,现在应该会更合理一点点
【功能】删除本地文件之前增加二次确认提醒
【功能】增加了一些无关紧要的分享
【样式】换了个logo,丑的更直白一些
【样式】调整了一些样式(如播放页的模糊和透明度、歌词样式等)
【样式】专辑描述文字默认6行,点击可以展开或折叠
【修复】修复部分情况下无法下载的问题
【插件】大量插件有更新,更新到此版本后更新订阅即可
v0.0.1-alpha.13 (2023.1.8)
【功能】主页入口增加“榜单”
【功能】歌单页新增“编辑歌单信息”,可以修改歌单名称和歌单封面
【修复】修复了一个会导致播放音乐时拖拽排序卡顿的问题,做了一些其他优化
【插件】部分插件有更新,可以在侧边栏更新
v0.0.1-alpha.12 (2022.12.25)
【功能】增加“单击搜索结果中单曲tab”时的行为配置
【功能】增加调试配置及调试面板,可用于查看插件的错误信息
【修复】修复部分情况下本地音乐中断时无法继续播放的问题
【修复】尝试修复扫描本地音乐,音乐文件太多时可能卡死的问题
v0.0.1-alpha.11 (2022.12.11)
【功能】完善音质功能
【功能】更新下载功能,支持根据音质下载文件;修复一些小问题
【功能】新增播放时被打断的设置,可设置为暂停或者暂时降低音量
【优化】调整侧边栏样式,侧边栏新增“定时关闭”功能
【优化】本地音乐读取歌词时,会自动读取同目录下的同名lrc文件作为歌词
【修复】修复安装插件时误弹安装失败提示的问题
【修复】修复部分情况下本地文件删除失败的问题
【修复】修复本地音乐在通知栏不显示音乐标题的问题
【插件】示例插件仓库中migu有更新(支持音质),需要可自行更新
v0.0.1-alpha.10 (2022.12.4)
【功能】支持自定义下载路径
【功能】支持插件排序(也就是搜索结果的排序)
【功能】增加音质相关的配置
【优化】弹窗、浮层的性能优化,页面嵌套较深时卡顿的情况应该会好一点
【优化】拖拽排序,比上个版本手感应该会好一点
【修复】修复在歌词页清空播放列表时白屏的问题
v0.0.1-alpha.9 (2022.11.20)
【功能】本地音乐读取内嵌歌词
【功能】批量编辑页新增了凑合能用的拖拽排序
【功能】歌曲详情浮层新增凑合能用的定时关闭
【功能】添加到歌单时可以新建歌单
【功能】本地音乐扫描支持外置sd卡;支持导入aac格式
【优化】优化播放列表浮层拉起时的锚定
【修复】修复更新弹窗无法滚动的问题
【修复】修复安卓12状态栏概率不沉浸的问题
【修复】修复安卓12、13播一首就停的问题
【插件】示例插件有更新,可以删掉原有插件重新导入
v0.0.1-alpha.8 (2022.11.13)
【功能】侧边栏插件设置新增“订阅插件”功能,订阅之后直接点击“更新插件”即可更新,不需要清空重装了
【功能】本地音乐读取内置封面
【功能】本地音乐歌单支持批量删除(不删除源文件)
【优化】重写导入本地音乐的逻辑,支持多选文件夹;修复部分机型重启应用时本地音乐消失的问题(可能需要删除后重新导入);支持导入flac,wav,wav,m4a,ogg等格式
【优化】重写播放列表浮层,拉起时会锚定到当前正在播放的歌曲
【优化】调整部分逻辑,可能会减少音频卡顿时卡死的情况
【修复】修复歌曲详情页进度条不连续的问题
【修复】修复某些情况下无法关联歌词的问题
【修复】修复正在播放的歌曲无歌词时,进入歌词页白屏的问题
【插件】示例插件有更新,可以删掉原有插件重新导入
v0.0.1-alpha.7 (2022.10.30)
新增功能:历史记录一键清空
新增功能:歌手页、本地歌单页支持批量编辑
修复移动网络下无法播放本地音乐的问题
样式优化&修复:toast提示显示异常、侧边栏样式优化、歌单内序号显示不全、【关于】页无法滑动
之前使用的拖拽排序组件在列表较大时有很严重的性能问题,会导致卡顿甚至白屏,因此批量编辑页暂时去掉了拖拽排序,后续会重新加上
v0.0.1-alpha.6 (2022.10.22)
重要!! v0.0.1-alpha.5以前的版本无法通过app正常更新,请在gitee/github发布页下载最新版本(v0.0.1-alpha.6),或QQ群自取;
导入本地音乐时,如果未识别本地音乐文件,则会使用文件名作为音乐名;
自建歌单、专辑详情页增加批量选择功能,可点击右上角查看(歌曲较多时可能有点卡,后续优化);使用方式:选中歌曲可进行下一首播放/加入歌单/下载/删除,长按拖动进行排序;删除/排序后点击保存按钮方可生效
调整歌单内歌曲编号字体大小;
v0.0.1-alpha.5 (2022.10.16)
新增功能:导入本地音乐文件
从网络源安装的插件可在插件页直接更新
调整下载逻辑
v0.0.1-alpha.4 (2022.10.06)
修复专辑详情页没有loading的问题
为插件新增Cookie管理器
优化播放页的显示
新增一键卸载全部插件的功能
v0.0.1-alpha.3 (2022.10.04)
修复设置页无法滚动的问题
修复播放结束时可能暂停的问题
v0.0.1-alpha.2 (2022.10.03)
插件协议更新,需要重新安装插件
支持批量导入插件
新增清空播放列表功能
优化搜索结果面板和播放专辑逻辑