# MusicFree

插件化、定制化、无广告的免费音乐播放器

Repository: https://github.com/maotoumao/MusicFree
Canonical: https://ross.abutalabs.com/products/musicfree
Homepage: https://musicfree.catcat.work
Language: TypeScript
License: AGPL-3.0
License Family: copyleft
Topics: free, music-player, plugin, react, react-native, typescript, musicfree
Last push: 2026-06-20T03:44:23+00:00
Link (homepage): https://musicfree.catcat.work
Link (site_page): https://musicfree.catcat.work/usage/mobile/install.html

## Health v2 (maintenance only)
Score: 73/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 88, release rhythm 39, longevity 100
- inputs: {"age_days": 1472, "days_push": 74, "days_rel": 326, "gap_med": 45.5, "n_releases_24m": 9}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 26353, forks 1872 (observed 2026-08-28T04:11:46.840197+00:00)

## What it is
MusicFree is a free, open-source, ad-free music player built with React Native (mobile) and React (desktop) that is fully plugin-driven. The app itself ships no music sources; all search, playback, playlist import, and lyrics features come from user-installed CommonJS plugins.

## Use cases
- play music from any online source via plugins
- listen to music without ads or tracking
- import playlists from third-party platforms
- view and link lyrics across songs
- develop custom music source plugins
- play local music files with a customizable UI

## When to choose
- you want an ad-free, privacy-respecting music player that stores data locally
- you want to aggregate music sources through community or self-written plugins
- you want a customizable player with dark/light themes and custom backgrounds

## When to avoid
- you expect built-in music sources or VIP song access out of the box
- you need iOS or official app-store distribution
- you are unwilling to vet third-party plugins for safety

## Facets
- artifact type: application
- maturity: active
- function: audio-processing, plugin-system, search-engine
- domain: media, entertainment, cross-platform, self-hosted
- platform: cross-platform
- tags: music-player, ad-free, react-native, customizable, lyrics, local-first, privacy, android, desktop

## Member repositories
- maotoumao/MusicFree (main) score 73
- maotoumao/MusicFreeDesktop (main) score 68
- maotoumao/MusicFreePlugins (plugin) score 65

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:46.840197+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:55:53.220894+00:00, confidence not recorded.
  - readme: https://github.com/maotoumao/MusicFree (fetched 2026-08-28T04:11:46.840197+00:00, sha 1f9115a5ebb7)
  - homepage: https://musicfree.catcat.work (fetched 2026-08-29T07:53:16.429377+00:00, sha 4e421a8379b4)
  - site_page: https://musicfree.catcat.work/usage/mobile/install.html (fetched 2026-08-29T07:53:16.438910+00:00, sha 4f344031f503)
- Data as of 2026-08-30T08:39:29.467469+00:00.