{"id":15036265,"url":"https://github.com/maotoumao/musicfreedesktop","last_synced_at":"2026-03-16T17:07:08.379Z","repository":{"id":183241498,"uuid":"646034058","full_name":"maotoumao/MusicFreeDesktop","owner":"maotoumao","description":"插件化、定制化、无广告的免费音乐播放器","archived":false,"fork":false,"pushed_at":"2025-04-11T14:10:13.000Z","size":13819,"stargazers_count":5037,"open_issues_count":124,"forks_count":406,"subscribers_count":28,"default_branch":"master","last_synced_at":"2025-05-11T12:00:50.870Z","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,"zenodo":null}},"created_at":"2023-05-27T04:40:47.000Z","updated_at":"2025-05-11T11:50:34.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":254029008,"owners_count":22002284,"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-09-24T20:30:39.690Z","updated_at":"2026-03-16T17:07:08.373Z","avatar_url":"https://github.com/maotoumao.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MusicFree 桌面版\n![GitHub Repo stars](https://img.shields.io/github/stars/maotoumao/MusicFreeDesktop) \n![GitHub forks](https://img.shields.io/github/forks/maotoumao/MusicFreeDesktop)\n![star](https://gitcode.com/maotoumao/MusicFreeDesktop/star/badge.svg)\n\n![GitHub License](https://img.shields.io/github/license/maotoumao/MusicFreeDesktop)\n![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/maotoumao/MusicFreeDesktop/total)\n![GitHub Issues or Pull Requests](https://img.shields.io/github/issues/maotoumao/MusicFreeDesktop)\n![GitHub package.json version](https://img.shields.io/github/package-json/v/maotoumao/MusicFreeDesktop)\n\n\u003ca href=\"https://trendshift.io/repositories/3961\" target=\"_blank\"\u003e\u003cimg src=\"https://trendshift.io/api/badge/repositories/3961\" alt=\"maotoumao%2FMusicFreeDesktop | Trendshift\" style=\"width: 250px; height: 55px;\" width=\"250\" height=\"55\"/\u003e\u003c/a\u003e\n---\n\n## 项目使用约定：\n本项目基于 AGPL 3.0 协议开源，使用此项目时请遵守开源协议。  \n除此外，希望你在使用代码时已经了解以下额外说明：\n\n1. 打包、二次分发 **请保留代码出处**：https://github.com/maotoumao/MusicFree\n2. 请不要用于商业用途，合法合规使用代码；\n3. 如果开源协议变更，将在此 Github 仓库更新，不另行通知。\n---\n\n## 简介\n\n一个插件化、定制化、无广告的免费音乐播放器。\n\u003e 当前版本支持 Windows 和 macOS 和 Linux\n\n\u003cimg src=\"./src/assets/imgs/wechat_channel1.png\" height=\"144px\" title=\"微信公众号\" style=\"display:inherit;\"/\u003e\n\n\n### 下载地址\n\n[飞书云文档](https://r0rvr854dd1.feishu.cn/drive/folder/IrVEfD67KlWZGkdqwjecLHFNnBb?from=from_copylink)\n\n## 特性\n\n- 插件化：本软件仅仅是一个播放器，本身**并不集成**任何平台的任何音源，所有的搜索、播放、歌单导入等功能全部基于**插件**。这也就意味着，**只要可以在互联网上搜索到的音源，只要有对应的插件，你都可以使用本软件进行搜索、播放等功能。** 关于插件的详细说明请参考 [安卓版 Readme 的插件部分](https://github.com/maotoumao/MusicFree#%E6%8F%92%E4%BB%B6)。\n\n- 插件支持的功能：搜索（音乐、专辑、作者、歌单）、播放、查看专辑、查看作者详细信息、导入单曲、导入歌单、获取歌词等。\n\n- 定制化：本软件可以通过主题包定义软件外观及背景，详见下方主题包一节。\n\n- 无广告：基于 AGPL3.0 协议开源，将会保持免费。\n\n- 隐私：软件所有数据存储在本地，本软件不会上传你的个人信息。\n\n## 插件\n\n插件协议和安卓版完全相同。\n\n[示例插件仓库](https://github.com/maotoumao/MusicFreePlugins)，你可以根据[插件开发文档](https://musicfree.catcat.work/plugin/introduction.html) 开发适配于任意音源的插件。\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.catcat.work\", // 整个软件的背景\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"}