musicfreeOH

项目概述

MusicFreeOH 由个人开发者将猫头猫的 MusicFree 移植到 HarmonyOS（鸿蒙），使用 ArkTS / ArkUI 原生开发而非跨端框架。它与原版共享同一套插件生态，.js 插件脚本通过内置 WebView 引擎执行，一个插件接入一个音源。

项目	内容
平台	HarmonyOS（鸿蒙）
语言	ArkTS / ArkUI
插件协议	兼容 MusicFree 插件
许可	AGPL-3.0

原版 MusicFree 的插件生态，搬到了鸿蒙原生界面上。

主要功能

• 插件化音源：兼容 MusicFree 插件协议，本地导入或插件链接网络导入均可
• 订阅源：支持 .json 插件列表订阅，一键同步更新，支持批量管理
• 自动与手动换源：在原版自动换源之外支持手动批量更换音源，避免音源失效
• 歌词：解析滚动展示、翻译歌词、本地歌词关联与歌词下载
• 下载与本地音乐：多任务并行下载、本地音频扫描、内嵌封面支持、修改元数据
• 歌单管理：创建重命名删除歌单，支持静态歌单导入和动态歌单订阅

快速上手

1. 从 Releases 下载最新版 .hap 包，用小白调试助手安装到 HarmonyOS 设备
2. 或使用 DevEco Studio 5.0+ 打开项目，执行 hvigorw assembleHap 自行构建
3. 首次启动会在 Download 文件夹自动创建 MusicFreeOH 文件夹存放插件与订阅源
4. 在插件页面导入 .js 插件或订阅 .json 列表即可开始听歌

系统要求

项目	要求
设备	HarmonyOS NEXT 设备或模拟器
构建	DevEco Studio 5.0 及以上，配置 HarmonyOS SDK

注意事项

• 音源自负：软件本身不内置不提供任何音频资源，音源全部来自第三方插件，其合法性由提供方与使用者负责
• 学习交流用途：本项目为开源免费的本地播放工具，请勿相信付费渠道资源