MusicFree 免费无广告音乐播放器

MusicFree 是一款为音乐爱好者打造的开源播放工具，支持安卓（Android）与鸿蒙（Harmony OS）系统。

MusicFree采用插件式设计理念，播放器本身不集成任何固定的音乐来源，诸如歌曲搜索、在线播放、歌词显示等所有关键功能，均需通过加载不同的插件模块来实现。

用户可以根据自己的喜好和需求，自由选择并安装各类插件，来拓展可收听的音乐资源。

当前版本支持Windows、macOS、Linux系统。

插件化架构设计

MusicFree 本身仅为播放器载体，不集成任何音源，所有功能依赖插件实现，包括：

• 搜索功能：支持音乐、专辑、作者、歌单多维度搜索

• 播放功能：实现音频播放、专辑查看、作者信息展示

• 导入功能：支持单曲、歌单导入及歌词获取

用户可根据插件开发文档，开发适配任意音源的插件。

定制化外观

通过主题包自定义软件外观，主题包需包含两个文件：

1、index.css：定义界面样式，支持CSS变量覆盖，预设变量包括：

:root {
  --primaryColor: #f17d34; /* 主色调 */
  --backgroundColor: #fdfdfd; /* 背景色 */
  --textColor: #333333; /* 主文本颜色 */
  /* 更多变量可参考源代码 */
}

可参考“暗黑模式”主题示例。

2、config.json：配置背景资源，支持HTML iframe嵌入，示例结构：

{
  "name": "主题名称",
  "preview": "#000000", // 支持颜色或图片
  "iframes": {
    "app": "http://musicfree.catcat.work", // 全局背景
    "side-bar": "@/background/sidebar.html" // 本地背景文件引用
  }
}

樱花主题等案例可查看示例仓库。

隐私安全

• 无广告：遵循AGPL3.0协议，永久免费使用

• 本地存储：所有数据存储于本地，无个人信息上传

• 代码透明：开源代码可审计，确保功能合规

MusicFree 安装和使用

项目启动流程

下载代码后，在根目录执行：

npm install  # 安装依赖
npm start    # 启动程序

主题与插件资源

• 主题包示例仓库：https://github.com/maotoumao/MusicFreeThemePacks

• 插件开发文档：参考安卓版README中的插件部分

• 下载地址：通过飞书云文档获取安装包