lyswhut

lyswhut/lx-music-mobile

TypeScript Apache-2.0 Media high-issue-count

一个基于 React native 开发的音乐软件

17.4k stars
2k forks
active
GitHub +86 / week

17.4k

Stars

2k

Forks

747

Open issues

8

Contributors

AI Analysis

LX Music Mobile is a React Native music player application for Android (5+) that aggregates music from multiple official Chinese platforms (Kuwo, Kugou, Migu) via public APIs. It serves users seeking an alternative music client with multi-source support and personal data synchronization capabilities, but is not designed for iOS users or those seeking a mainstream, beginner-friendly experience.

Media Application Discovery value: 5/10
Documentation 7/10
Activity 9/10
Community 8/10
Code quality 5/10

Inferred from signals mentioned in the README (tests, CI, type safety) — not a review of the actual code.

Overall score 7/10

AI's overall editorial judgment — not an average of the bars above, can weigh other factors too.

react-native music-player android-app multi-source-aggregation typescript
Actively maintained Popular Niche/specialized use case Apache-2.0 licensed Production ready
Deep Analysis · Based on README and public signals
3w ago

LX Music Mobile: Open-source Android music player relying on user-supplied streaming sources

LX Music Mobile is a React Native-based Android music app that functions as a front-end player, fetching audio via user-configured 'custom sources' rather than bundling its own streaming rights. It targets Chinese-speaking Android users who want an ad-free, playlist-capable music experience that aggregates content from platforms like Kuwo, Kugou, and Migu. The project is the mobile companion to the widely-used lx-music-desktop (51k+ stars) and shares its ecosystem of community-maintained source scripts. It intentionally does not plan iOS or HarmonyOS NEXT support, limiting its reach.

Origin

Created in May 2021 as a mobile extension of the desktop LX Music project, which predates it by several years. The mobile version matured steadily, reaching v1.0.0 with a standalone data sync server and building an active Chinese open-source music tool ecosystem.

Growth

Growth is driven almost entirely by the popularity of the parent desktop project (51k stars) and the shared custom-source ecosystem. The 17k stars reflect organic spread within Chinese tech communities via forums, social media, and mirror sites. Recent star velocity (38/week) is modest but consistent, suggesting a stable, loyal user base rather than viral growth. The README's note about third-party redistribution channels implies significant real-world distribution beyond GitHub.

In production

No app store metrics, download counts (the download badge is commented out in the README), or enterprise usage data are publicly visible. However, 17k+ stars, 1,974 forks, a companion desktop project with 51k stars, and explicit warnings about third-party redistribution channels collectively suggest substantial real-world usage within the Chinese Android user community, even if precise numbers are unverifiable.

Code analysis
Architecture

Likely a React Native application using Redux for state management, targeting Android 5+. Based on README, audio playback is decoupled from source resolution: the app passes song metadata to a user-provided 'source' script, receives a URL, and plays it. This plugin-style source architecture is similar to the desktop version. A separate sync server (lx-music-sync-server) handles cross-device data sync, indicating a modular design.

Tests

not documented in README

Maintenance

Last push was 2026-05-28, approximately 25 days before evaluation date, indicating active maintenance. The presence of separate CI workflows for release and beta builds suggests a structured release process. The project references a CHANGELOG and active GitHub Issues, pointing to ongoing development engagement.

Honest verdict

ADOPT IF: you are a Chinese-speaking Android user comfortable configuring custom sources, want an ad-free aggregator with playlist and sync features, and accept the legal ambiguity inherent in the source model. AVOID IF: you need iOS support, want a legally straightforward licensed music app, or are uncomfortable maintaining third-party source scripts. MONITOR IF: you are tracking the Chinese open-source music tool ecosystem or interested in React Native architecture for media-heavy mobile apps.

Independent dimensions

Mainstream potential

3/10

Technical importance

5/10

Adoption evidence

6/10

Risks
  • Legal and regulatory risk: the custom-source model operates in a gray area regarding copyright, and the README's extensive disclaimer language acknowledges this explicitly. Platform takedowns or legal pressure on source script maintainers could break functionality.
  • No iOS or HarmonyOS NEXT support is planned, permanently excluding a large portion of the potential user base and limiting mainstream potential.
  • Dependency on community-maintained source scripts (e.g., lx-music-source) means playback can break whenever music platforms change their APIs, and fixes depend on volunteer contributors rather than the core team.
  • Single primary maintainer risk: the project appears to be led by one developer (lyswhut), which creates a bus-factor concern for long-term sustainability.
  • Distribution fragmentation: the README warns that many redistribution channels are unauthorized third parties, which may expose users to tampered builds and dilutes the project's ability to communicate updates or security fixes.
Prediction

Likely to remain a stable, popular tool within its Chinese Android niche for the next 1-2 years, sustained by the desktop ecosystem. Mainstream expansion appears unlikely given the intentional platform limitations and legal constraints inherent to its architecture.

0 found this helpful

Newsletter

Get analyses like this every Monday

Free weekly digest of the most interesting open-source discoveries.

Languages

No language breakdown available.

Information

Language
TypeScript
License
Apache-2.0
Last updated
2d ago
Created
63mo ago
Analyzed with
anthropic/claude-haiku-4-5

Stars over time

Loading…

No commit data available.

Contributors over time

Top 100 contributors only — repos with more will plateau at 100.

Loading…

Open issues

No open issues — clean slate.

Open pull requests

No open pull requests.

Top contributors

Contributor data not available yet.

Recent releases

No releases published yet.

Similar repos

lyswhut

lyswhut/lx-music-desktop

LX Music Desktop is an Electron + Vue 3 desktop music player application...

52.1k TypeScript Media
guoyue2010

guoyue2010/lxmusic-

LX Music is a music source aggregator and plugin system for the LX Music...

4.6k JavaScript Media
lovegaoshi

lovegaoshi/azusa-player-mobile

Azusa-Player-Mobile is a third-party Bilibili audio player for iOS and Android,...

1.3k TypeScript Media
pdone

pdone/lx-music-source

lx-music-source provides music source integrations for the Lx Music player...

7.2k JavaScript Media
Macrohard0001

Macrohard0001/lx-ikun-music-sources

This repository collects and curates music sources for LX Music and IKUN Music,...

1.7k JavaScript Media
vs. alternatives
lx-music-desktop (lyswhut)

The direct desktop sibling with 3x the stars. The mobile app intentionally complements rather than replaces it, sharing the same source ecosystem and sync server. Mobile version lacks desktop's broader platform reach.

MusicFree (maotoumao)

A closer direct competitor with 25k stars and also plugin-based architecture on mobile. MusicFree appears to have broader community mindshare. Both serve the same niche; LX Music Mobile benefits from an established user base from the desktop project.

azusa-player-mobile (lovegaoshi)

A much smaller project (1.3k stars) also built in TypeScript for mobile music. Significantly less adoption and ecosystem maturity than LX Music Mobile.

lx-music-source (pdone)

Not a direct competitor — it is a community-maintained source repository that LX Music Mobile depends on. Its 6.9k stars indicate a healthy supporting ecosystem.

Jellify-Music/App

Targets Jellyfin server users specifically (1.7k stars), serving a completely different niche (self-hosted media servers) compared to LX Music Mobile's streaming-source model.