lyswhut

lyswhut/lx-music-desktop

TypeScript Apache-2.0 Media Single maintainer risk

一个基于 Electron 的音乐软件

52.1k stars
6.9k forks
active
GitHub +121 / week

52.1k

Stars

6.9k

Forks

1.2k

Open issues

19

Contributors

v2.12.2 01 May 2026

AI Analysis

LX Music Desktop is an Electron + Vue 3 desktop music player application targeting Windows, macOS, and Linux users who want to stream and manage music from Chinese music platforms. It is best suited for Chinese-speaking users familiar with navigating third-party music tooling, as it requires external scripts (e.g., a Tampermonkey userscript) to unlock full functionality and explicitly does not prioritize beginner-friendliness. Users outside the Chinese music ecosystem or those expecting a sel...

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

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

Overall score 8/10

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

music-player electron vue3 desktop-app chinese-music
Actively maintained Popular Niche/specialized use case Production ready
Deep Analysis · Based on README and public signals
3w ago

LX Music: A popular open-source Electron desktop music player for Chinese streaming platforms with 51k+ stars

LX Music Desktop is an Electron + Vue 3 desktop music player targeting Chinese-speaking users who want to aggregate content from major Chinese streaming platforms (Kuwo, Kugou, Migu, etc.) through a 'custom source' plugin system. It does not bundle audio sources itself — users must configure third-party sources — which is a deliberate legal distancing strategy. With 51k+ GitHub stars, a companion mobile app, data sync server, and open API, it has evolved into a small ecosystem. Its primary audience is technically comfortable Chinese users dissatisfied with official platform clients.

Origin

Created in August 2019 as a personal Electron project, LX Music grew steadily through the Chinese open-source community. It expanded into a mobile companion app, a sync server, and an open API layer, reflecting organic maturation over roughly seven years.

Growth

Growth was driven by strong demand from Chinese users wanting a unified, ad-free desktop client for multiple streaming services. The 'custom source' architecture sidestepped direct legal exposure, enabling public hosting on GitHub. Star accumulation appears organic via Chinese developer communities and social media. The 141 stars gained in the past 7 days (as of 2026-06-20) suggests stable but slowing momentum — the project is past its explosive growth phase but still retains a large, active user base.

In production

51,673 GitHub stars and 6,874 forks are unusually high for a regional desktop app and strongly imply large real-world usage. The companion mobile repo (17k+ stars), a dedicated sync server project, a Greasyfork userscript with a public install count, and a companion source repo (lx-music-source, 6.8k stars) collectively suggest an active user ecosystem. However, precise download or active-user numbers are not publicly disclosed in the README (the download counter badge is commented out), so exact adoption scale cannot be confirmed.

Code analysis
Architecture

Likely a multi-process Electron application with a Vue 3 renderer process and a Node.js main process. The README confirms Electron 30+ and Vue 3 stack. Audio playback appears to be delegated to URLs returned by user-configured 'custom sources' — the app itself appears to be a UI shell and playlist manager rather than a media acquisition layer. A portable mode (Windows), Scheme URL support, an open HTTP API, and a separate sync server suggest a modular, extensible design.

Tests

Not documented in README

Maintenance

Last push was 2026-06-14, six days before the evaluation date — clearly actively maintained. The project has active CI workflows (Build and Build Beta badges), a dev branch for ongoing development, and a documented changelog. Maintenance appears healthy and consistent for a mature open-source project.

Honest verdict

ADOPT IF: You are a Chinese-speaking user who wants a unified, ad-free desktop player for Chinese streaming platforms and are comfortable configuring third-party custom sources and accepting the legal grey area involved. AVOID IF: You expect out-of-the-box audio sources (none are bundled), need official DRM-protected content to work seamlessly, or are outside the Chinese streaming ecosystem where the app provides little value. MONITOR IF: You are watching for signs of legal pressure from Chinese music platforms, which could force the project off GitHub or require architectural changes.

Independent dimensions

Mainstream potential

2/10

Technical importance

4/10

Adoption evidence

7/10

Risks
  • Legal grey area: The custom-source model distances the project from direct infringement claims, but the app is fundamentally designed to access paid streaming content without authorization, which could attract platform or regulatory action.
  • Source dependency: The app is effectively useless without functional third-party custom sources, which are maintained separately and may break as platforms update their APIs — a fragile external dependency.
  • Electron bundle size and performance: Electron-based desktop apps carry well-known overhead in memory and disk usage; this is an inherent tradeoff of the technology stack rather than a fixable bug.
  • Primarily Chinese-language documentation and community: Non-Chinese speakers face a significant barrier to setup, contribution, and support.
  • Platform risk: Chinese music platforms (Tencent Music, NetEase, etc.) have aggressively pursued legal action against similar tools in the past; the project's long-term availability on GitHub is not guaranteed.
Prediction

LX Music will likely maintain its established user base among Chinese desktop users for the near term, with slow but steady star accumulation. Major growth is unlikely given market saturation in its niche, but the project appears stable and unlikely to be abandoned soon given consistent recent commits.

0 found this helpful

Newsletter

Get analyses like this every Monday

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

Languages

TypeScript
39.5%
Vue
29.1%
JavaScript
28.9%
Less
2.2%
HTML
0.2%

Information

Language
TypeScript
License
Apache-2.0
Last updated
2d ago
Created
84mo ago
Analyzed with
anthropic/claude-sonnet-4-6

Stars over time

Loading…

Contributors over time

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

Loading…

Similar repos

lyswhut

lyswhut/lx-music-mobile

LX Music Mobile is a React Native music player application for Android (5+)...

17.4k TypeScript Media
guoyue2010

guoyue2010/lxmusic-

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

4.6k JavaScript Media
qier222

qier222/YesPlayMusic

YesPlayMusic is a third-party Netease Cloud Music player built with Vue.js and...

33k Vue Media
hoowhoami

hoowhoami/EchoMusic

EchoMusic is a desktop music player built with Electron and Vue 3 that...

2.3k TypeScript Media
maotoumao

maotoumao/MusicFreeDesktop

MusicFree Desktop is a plugin-based, ad-free music player for Windows, macOS,...

8.6k TypeScript Media
vs. alternatives
YesPlayMusic

32k stars; focuses on NetEase Cloud Music specifically with a cleaner UI and official API integration. More polished for its single-source use case but narrower platform coverage than LX Music's multi-source approach.

Listen1 Desktop

11k stars; similar multi-platform aggregation concept (NetEase, QQ Music, etc.), browser-extension origins. LX Music has significantly more stars and a more mature ecosystem with mobile companion and sync server.

MusicFreeDesktop

8.4k stars; newer entrant with a similar plugin-based source architecture. Appears to be a direct conceptual competitor but has considerably lower adoption than LX Music.

lx-music-mobile

17k stars; the official mobile companion by the same author. Complements rather than competes — the two projects share a sync server and likely share users.

Official platform clients (Kugou, Kuwo, Migu)

Official clients include ads, DRM, and platform lock-in. LX Music's appeal is precisely avoiding these constraints, serving users who prefer a unified, lightweight alternative — a structurally different value proposition.