Moumusic

A source-driven music client for iOS and Android

SwiftUI on iOS · LX User API sources · LX Music Mobile on Android

仅供学习，请支持正版！⚠️

For educational purposes only. Please support the original work! ⚠️

简体中文 · English

official website： https://music.nadev.xyz

Moumusic is an independent cross-platform music client. It uses Kumone's native SwiftUI experience as the iOS foundation and LX Music Mobile's source protocol and Android client. Public catalog data is used for discovery; audio playback is resolved through LX User API sources imported and enabled by the user.

Moumusic does not bundle third-party source URLs or provide NetEase login. Add only sources you are authorized to use and follow the terms and copyright rules of each service.

Features

• LX User API source import from JSON, JavaScript or an online URL
• Source availability checks, enable/switch/delete management
• Kuwo, Kugou, QQ Music, NetEase, Migu and aggregate search
• Source-resolved playback with lyrics, artwork and quality selection
• Native iOS player, queue, synced lyrics, lock-screen controls and Control Center playback controls
• WidgetKit current-lyrics widget for Home Screen and Lock Screen
• Public NetEase catalog: recommendations, discovery, playlists, comments and playlist import
• Native LX Music Mobile Android source management, search, lyrics, downloads and playback
• Simplified Chinese and English interfaces

Add a source

On iOS, open Library → Settings → LX Sources, choose Import from File or Import from Online URL, then select and test the source. On Android, use the original LX Music Mobile source-management page.

The app intentionally does not ship a default third-party provider URL. Imported sources are user configuration and remain the user's responsibility.

Installation

Download the latest builds from Releases. iOS releases are unsigned IPAs and must be installed with your own certificate, AltStore, SideStore, TrollStore or another sideloading tool.

Build

Android

cd platforms/android
npm ci
npm run pack:android

iOS

Requires macOS and Xcode. XcodeGen is used to generate the app and WidgetKit extension targets:

cd platforms/ios/ios
xcodegen generate
xcodebuild -project KumoneIOS.xcodeproj -scheme KumoneIOS -configuration Release -sdk iphoneos build

Architecture

platforms/ios/
├── Sources/Kumone/
│   ├── Core/API/          NetEase catalog and LX User API bridge
│   ├── Core/Models/       Track models and lyric parsers
│   ├── Core/Player/       Queue, AVPlayer, lyrics and system playback state
│   ├── Core/Storage/      Settings, account and image cache
│   ├── DesignSystem/      SwiftUI colors, cards, glass surfaces and layout
│   └── Features/          Home, search, library, settings and player pages
├── ios/                   iOS app shell and XcodeGen manifest
├── ios/MoumusicWidget/    WidgetKit current-lyrics extension
├── Scripts/               iOS packaging and release helpers
└── docs/                  Icon and product screenshots
platforms/android/         LX Music Mobile React Native client

Upstream projects

• Kumone — native SwiftUI music client foundation and iOS UI direction
• LX Music Mobile — source protocol and Android client

Moumusic-specific changes are documented in THIRD_PARTY_NOTICES.md. Upstream code and assets retain their original license obligations.

License

Moumusic includes the complete LGPL-3.0-only and GPL-3.0-only texts. Apply the license stated by each source file or component. Kumone code remains LGPL-3.0-only and LX Music Mobile code remains Apache-2.0; these obligations are not replaced by Moumusic's project documentation.

Star History