{"id":13618284,"url":"https://github.com/maotoumao/MusicFreeDesktop","last_synced_at":"2025-04-14T10:31:32.323Z","repository":{"id":183241498,"uuid":"646034058","full_name":"maotoumao/MusicFreeDesktop","owner":"maotoumao","description":"插件化、定制化、无广告的免费音乐播放器","archived":false,"fork":false,"pushed_at":"2025-04-04T13:57:02.000Z","size":13815,"stargazers_count":4610,"open_issues_count":110,"forks_count":385,"subscribers_count":27,"default_branch":"master","last_synced_at":"2025-04-10T15:56:20.465Z","etag":null,"topics":["electron","free","music","music-player","react","typescript"],"latest_commit_sha":null,"homepage":"https://musicfree.catcat.work","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maotoumao.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-05-27T04:40:47.000Z","updated_at":"2025-04-10T15:01:07.000Z","dependencies_parsed_at":"2024-08-01T20:47:13.165Z","dependency_job_id":"79c04413-7d70-48b9-ae8c-769f7cbc0fd9","html_url":"https://github.com/maotoumao/MusicFreeDesktop","commit_stats":{"total_commits":428,"total_committers":3,"mean_commits":"142.66666666666666","dds":"0.011682242990654235","last_synced_commit":"7c8bd0ad94d3d77ee364a95362dcde34d7e172ff"},"previous_names":["maotoumao/musicfreedesktop"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maotoumao%2FMusicFreeDesktop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maotoumao%2FMusicFreeDesktop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maotoumao%2FMusicFreeDesktop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maotoumao%2FMusicFreeDesktop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maotoumao","download_url":"https://codeload.github.com/maotoumao/MusicFreeDesktop/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248862643,"owners_count":21173844,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["electron","free","music","music-player","react","typescript"],"created_at":"2024-08-01T20:01:57.622Z","updated_at":"2025-04-14T10:31:27.307Z","avatar_url":"https://github.com/maotoumao.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","B站"],"sub_categories":[],"readme":"# MusicFree 桌面版\n\n## 本项目基于 GPL 3.0 协议开源，不禁止二次分发，但使用代码时请遵守如下规则：\n\n1. 二次分发版必须同样遵循 GPL 3.0 协议，**开源且免费**\n2. **合法合规使用代码，禁止用于商业用途; 修改后的软件造成的任何问题由使用此代码的开发者承担**\n3. 打包、二次分发 **请保留代码出处**：https://github.com/maotoumao/MusicFree\n4. 如果使用此代码的开发者不同意以上三条，则视为 **二次分发版遵守 CC0 协议**\n5. 如果开源协议变更，将在此 Github 仓库更新，不另行通知\n\n---\n\n## 简介\n\n一个插件化、定制化、无广告的免费音乐播放器。\n\u003e 当前测试版支持 windows 和 macos x64；macos m1/m2 和 linux 可自行打包。\n\n\u003cimg src=\"./src/assets/imgs/wechat_channel1.png\" height=\"144px\" title=\"微信公众号\" style=\"display:inherit;\"/\u003e\n\n\n### 下载地址\n\n[蓝奏云下载地址](https://wwzb.lanzoue.com/b042da1xe)\n\n## 特性\n\n- 插件化：本软件仅仅是一个播放器，本身**并不集成**任何平台的任何音源，所有的搜索、播放、歌单导入等功能全部基于**插件**。这也就意味着，**只要可以在互联网上搜索到的音源，只要有对应的插件，你都可以使用本软件进行搜索、播放等功能。** 关于插件的详细说明请参考 [安卓版 Readme 的插件部分](https://github.com/maotoumao/MusicFree#%E6%8F%92%E4%BB%B6)。\n\n- 插件支持的功能：搜索（音乐、专辑、作者、歌单）、播放、查看专辑、查看作者详细信息、导入单曲、导入歌单、获取歌词等。\n\n- 定制化：本软件可以通过主题包定义软件外观及背景，详见下方主题包一节。\n\n- 无广告：基于 GPL3.0 协议开源，将会保持免费。\n\n- 隐私：软件所有数据存储在本地，本软件不会上传你的个人信息。\n\n## 插件\n\n插件协议和安卓版完全相同。\n\n[示例插件仓库](https://github.com/maotoumao/MusicFreePlugins)，你可以根据[插件开发文档](http://musicfree.upup.fun/docs/tutorial-plugin/intro/) 开发适配于任意音源的插件。\n\n## 主题包\n\n主题包是一个文件夹，文件夹内必须包含两个文件：\n\n```bash\nindex.css\nconfig.json\n```\n\n### index.css\n\nindex.css 中可以覆盖界面中的任何样式。你可以通过定义 css 变量来完成大部分颜色的替换，也可以查看源代码，根据类名等覆盖样式。\n\n支持的 css 变量如下：\n\n``` css\n:root {\n  --primaryColor: #f17d34; // 主色调\n  --backgroundColor: #fdfdfd; // 背景色\n  --dividerColor: rgba(0, 0, 0, 0.1); // 分割线颜色\n  --listHoverColor: rgba(0, 0, 0, 0.05); // 列表悬浮颜色\n  --listActiveColor: rgba(0, 0, 0, 0.1); // 列表选中颜色\n  --textColor: #333333; // 主文本颜色\n  --maskColor: rgba(51, 51, 51, 0.2); // 遮罩层颜色\n  --shadowColor: rgba(0, 0, 0, 0.2); // 对话框等阴影颜色\n  /** --shadow:  // shadow属性 */\n  --placeholderColor: #f4f4f4; // 输入区背景颜色\n  --successColor: #08A34C; // 成功颜色\n  --dangerColor: #FC5F5F; // 危险颜色\n  --infoColor: #0A95C8; // 通知颜色\n  --headerTextColor: white; // 顶部文本颜色\n}\n```\n\n具体的例子可以参考 [暗黑模式](https://github.com/maotoumao/MusicFreeThemePacks/blob/master/darkmode/index.css)\n\n除了通过 css 定义常规样式外，也可以通过在 config.json 中定义 iframes 字段，用来把任意的 html 文件作为软件背景，这样可以实现一些单纯用 css 无法实现的效果。\n\n### config.json\n\nconfig.json 是一个配置文件。\n\n```json\n{\n    \"name\": \"主题包的名称\",\n    \"preview\": \"#000000\", // 预览图，支持颜色或图片；\n    \"description\": \"描述文本\",\n    \"iframes\": {\n        \"app\": \"http://musicfree.upup.fun\", // 整个软件的背景\n        \"header\": \"\", // 头部区域的背景\n        \"body\": \"\", // 侧边栏+主页面区域的背景\n        \"side-bar\": \"\", // 侧边栏区域的背景\n        \"page\": \"\", // 主页面区域的背景\n        \"music-bar\": \"\", // 底部音乐栏的背景\n\n    }\n}\n```\n\n如果需要指向本地的图片，可以通过 ```@/``` 表示主题包的路径；preview、iframes、以及 iframes 指向的 html 文件都会把 ```@/``` 替换为 ```主题包路径```。详情可参考 [樱花主题](https://github.com/maotoumao/MusicFreeThemePacks/tree/master/sakura)\n\n### 主题包示例\n\n示例仓库：https://github.com/maotoumao/MusicFreeThemePacks\n\n几个主题包效果截图：\n\n#### 暗黑模式\n[源代码](https://github.com/maotoumao/MusicFreeThemePacks/tree/master/darkmode)\n\n![暗黑模式](./.imgs/darkmode.png)\n\n#### 背景图片\n[源代码](https://github.com/maotoumao/MusicFreeThemePacks/tree/master/night-star)\n\n![背景图片](./.imgs/night-star.png)\n\n#### fliqlo\n[源代码](https://github.com/maotoumao/MusicFreeThemePacks/tree/master/fliqlo)\n\n![fliqlo](./.imgs/fliqlo.gif)\n\n#### 樱花\n[源代码](https://github.com/maotoumao/MusicFreeThemePacks/tree/master/sakura)\n\n![樱花](./.imgs/sakura.gif)\n\n#### 雨季\n[源代码](https://github.com/maotoumao/MusicFreeThemePacks/tree/master/rainy-season)\n\n![雨季](./.imgs/rainy-season.gif)\n\n## 启动项目\n\n下载仓库代码之后，在根目录下执行：\n\n```bash\nnpm install\nnpm start\n```\n\n## 支持这个项目\n\n如果你喜欢这个项目，或者希望我可以持续维护下去，你可以通过以下任何一种方式支持我;)\n\n1. Star 这个项目，分享给你身边的人；\n2. 关注公众号【一只猫头猫】获取最新信息；\n\n\u003cimg src=\"./src/assets/imgs/wechat_channel.jpg\" height=\"160px\" title=\"微信公众号\" style=\"display:inherit;\"/\u003e\n\n## 截图\n\n![screenshot](./.imgs/screenshot.png)\n\n![screenshot](./.imgs/screenshot1.png)\n\n![screenshot](./.imgs/screenshot2.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaotoumao%2FMusicFreeDesktop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaotoumao%2FMusicFreeDesktop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaotoumao%2FMusicFreeDesktop/lists"}