musicfreeOH

Project Overview

MusicFreeOH is an individual developer's port of maotoumao's MusicFree to HarmonyOS, built natively with ArkTS / ArkUI rather than a cross-platform framework. It shares the same plugin ecosystem as the original: .js plugin scripts run through a built-in WebView engine, with one plugin per audio source.

Item	Value
Platform	HarmonyOS
Language	ArkTS / ArkUI
Plugin protocol	MusicFree-compatible
License	AGPL-3.0

The original MusicFree plugin ecosystem, reborn on a native HarmonyOS interface.

Key Features

• Plugin sources: MusicFree plugin protocol compatible; import locally or from plugin URLs
• Subscriptions: supports .json plugin-list subscriptions with one-tap sync and batch management
• Auto and manual source switching: beyond the original auto-switching, manually swap sources in batch when one breaks
• Lyrics: scrolling display, translation, local lyric association, and lyric downloads
• Downloads and local music: parallel multi-task downloads, local audio scanning, embedded cover support, and metadata editing
• Playlist management: create, rename, and delete playlists; static imports and dynamic subscriptions supported

Quick Start

1. Download the latest .hap from Releases and install it on a HarmonyOS device with the auto-installer tool
2. Or open the project in DevEco Studio 5.0+ and build with hvigorw assembleHap
3. On first launch a MusicFreeOH folder is created in Download for plugins and subscriptions
4. Import a .js plugin or a .json subscription list on the plugin page to start listening

System Requirements

Item	Requirement
Device	HarmonyOS NEXT device or emulator
Build	DevEco Studio 5.0+ with the HarmonyOS SDK

Notes

• Source responsibility: the app bundles no audio content; all sources come from third-party plugins whose legality rests with their providers and users
• For learning: this is a free open-source local player; do not trust paid channel resources