+1
Daily
9,152
stars
890
forks
45
watchers
56
prs
376
issues
12
releases
README
MusicFree 桌面版
!GitHub Repo stars
!GitHub forks
!star
!GitHub License
!GitHub Downloads (all assets, all releases)
!GitHub Issues or Pull Requests
!GitHub package.json version
---
项目使用约定:
本项目基于 AGPL 3.0 协议开源,使用此项目时请遵守开源协议。
除此外,希望你在使用代码时已经了解以下额外说明:
1. 打包、二次分发 请保留代码出处:https://github.com/maotoumao/MusicFree
2. 请不要用于商业用途,合法合规使用代码;
3. 如果开源协议变更,将在此 Github 仓库更新,不另行通知。
---
简介
一个插件化、定制化、无广告的免费音乐播放器。
当前版本支持 Windows 和 macOS 和 Linux
下载地址
飞书云文档
特性
- 插件化:本软件仅仅是一个播放器,本身并不集成任何平台的任何音源,所有的搜索、播放、歌单导入等功能全部基于插件。这也就意味着,只要可以在互联网上搜索到的音源,只要有对应的插件,你都可以使用本软件进行搜索、播放等功能。 关于插件的详细说明请参考 安卓版 Readme 的插件部分。
- 插件支持的功能:搜索(音乐、专辑、作者、歌单)、播放、查看专辑、查看作者详细信息、导入单曲、导入歌单、获取歌词等。
- 定制化:本软件可以通过主题包定义软件外观及背景,详见下方主题包一节。
- 无广告:基于 AGPL3.0 协议开源,将会保持免费。
- 隐私:软件所有数据存储在本地,本软件不会上传你的个人信息。
插件
插件协议和安卓版完全相同。
示例插件仓库,你可以根据插件开发文档 开发适配于任意音源的插件。
主题包
主题包是一个文件夹,文件夹内必须包含两个文件:
bash
index.css
config.json
index.css
index.css 中可以覆盖界面中的任何样式。你可以通过定义 css 变量来完成大部分颜色的替换,也可以查看源代码,根据类名等覆盖样式。
支持的 css 变量如下:
css
:root {
--primaryColor: f17d34; // 主色调
--backgroundColor: fdfdfd; // 背景色
--dividerColor: rgba(0, 0, 0, 0.1); // 分割线颜色
--listHoverColor: rgba(0, 0, 0, 0.05); // 列表悬浮颜色
--listActiveColor: rgba(0, 0, 0, 0.1); // 列表选中颜色
--textColor: 333333; // 主文本颜色
--maskColor: rgba(51, 51, 51, 0.2); // 遮罩层颜色
--shadowColor: rgba(0, 0, 0, 0.2); // 对话框等阴影颜色
/ --shadow: // shadow属性 /
--placeholderColor: f4f4f4; // 输入区背景颜色
--successColor: 08A34C; // 成功颜色
--dangerColor: FC5F5F; // 危险颜色
--infoColor: 0A95C8; // 通知颜色
--headerTextColor: white; // 顶部文本颜色
}
具体的例子可以参考 暗黑模式
除了通过 css 定义常规样式外,也可以通过在 config.json 中定义 iframes 字段,用来把任意的 html 文件作为软件背景,这样可以实现一些单纯用 css 无法实现的效果。
config.json
config.json 是一个配置文件。
json
{
"name": "主题包的名称",
"preview": "000000", // 预览图,支持颜色或图片;
"description": "描述文本",
"iframes": {
"app": "http://musicfree.catcat.work", // 整个软件的背景
"header": "", // 头部区域的背景
"body": "", // 侧边栏+主页面区域的背景
"side-bar": "", // 侧边栏区域的背景
"page": "", // 主页面区域的背景
"music-bar": "", // 底部音乐栏的背景
}
}
如果需要指向本地的图片,可以通过 @/ 表示主题包的路径;preview、iframes、以及 iframes 指向的 html 文件都会把 @/ 替换为 主题包路径。详情可参考 樱花主题
主题包示例
示例仓库:https://github.com/maotoumao/MusicFreeThemePacks
几个主题包效果截图:
暗黑模式
源代码
!暗黑模式
背景图片
源代码
!背景图片
fliqlo
源代码
!fliqlo
樱花
源代码
!樱花
雨季
源代码
!雨季
启动项目
下载仓库代码之后,在根目录下执行:
bash
npm install
npm start
支持这个项目
如果你喜欢这个项目,或者希望我可以持续维护下去,你可以通过以下任何一种方式支持我;)
1. Star 这个项目,分享给你身边的人;
2. 关注公众号【一只猫头猫】获取最新信息;
截图
!screenshot
!screenshot
!screenshotTop issues
#101album cover 无法显示8 comments · 2024-04-02#95下载文件后缀这样了7 comments · 2024-03-12#155win的安装后白屏6 comments · 2024-08-13#93希望可以增加对龙架构CPU的支持!6 comments · 2024-03-07#449为降低内存占用,让AI从electron移植到tauri了,有人需要么?5 comments · 2026-10-21#225桌面端建议添加 调试面板 开关5 comments · 2025-03-07#107Linux 将来能否支持 AppImage 格式打包5 comments · 2024-04-16#272mac os 安装后提示文件已经损坏无法打开。4 comments · 2025-06-19
Discussions
#450基于 dev 最新代码的一组界面体验修复(分支已公开)0 comments · 2026-10-31#436希望在搜索框中输入全拼字母时可以有歌曲名称的模糊提示,这样可以提高几倍的搜索速度,请看洛雪的此项功能0 comments · 2026-08-20#408还有能用的插件吗0 comments · 2026-05-04#403苹果手机有可以用的吗?0 comments · 2026-04-21#377希望增加自定义下载的歌曲名称的功能0 comments · 2026-03-17#368插件在哪里下载呢?1 comments · 2026-03-16#350时长过滤功能0 comments · 2026-01-23#303桌面歌词疑似内存泄漏0 comments · 2025-09-03
Latest release
v0.0.8 v0.0.8 2025-10-26【修复】修复了一些可能导致白屏的问题