# [MeiloX](https://github.com/NEORUAA/MeiloX) ### A multi-source Android music client based on Mei, inspired by the Apple Music design ![Android](https://img.shields.io/badge/Platform-Android-green?logo=android) ![Jetpack Compose](https://img.shields.io/badge/UI-Jetpack%20Compose-blue) ![License](https://img.shields.io/badge/License-GPLv3-orange) ![Status](https://img.shields.io/badge/Development-In%20Progress-yellow)
--- Language: [中文](./README.md) | **English** | [日本語](./README_ja-JP.md) ## About MeiloX is a multi-source music client built on [Mei](https://github.com/ljyh223/Mei). It comes with a removable NetEase Cloud Music source and uses **Jetpack Compose** to bring the layered design, Liquid Glass, and immersive player experience of iOS 27 to Android. The project focuses on three goals: - Organizing music content in an iOS-style interface; - Creating an immersive listening experience with Liquid Glass, dynamic backgrounds, and album artwork; - Preserving familiar music source features such as search, playlists, lyrics, and profiles. > MeiloX is an unofficial personal open-source project and is not affiliated with NetEase Cloud Music or Apple. The project does not provide music content; music and its associated copyrights belong to their respective owners. ## Features - Cookie and mobile protocol login and account information for supported sources; - Search for songs, albums, artists, and playlists; - Playback queue, shuffle, repeat, and sleep timer; - Playback history, liked music, playlist management, and local favorites; - Album details, artist pages, daily recommendations, and FM playback; - Word-by-word and multilingual lyrics; - Apple Music-style full-screen player, mini player, and floating lyrics; - Light and dark themes, dynamic album backgrounds, and Liquid Glass effects; - A preinstalled, removable NetEase Cloud Music source, a separate QQ Music plugin, and automatic playback source fallback in user-defined order; - A [plugin marketplace](https://github.com/NEORUAA/MeiloX-Source-Registry), version checks on launch, and automatic updates, with plugin submissions accepted via pull requests. Features are still evolving, and availability may change with app versions and music source APIs. See [Music Sources](docs/music-sources.md) for importing, configuring, and switching sources. Developers can also refer to the [Plugin Specification and SDK](docs/source-plugin-spec.md) and [Architecture and Compatibility Migration](docs/multi-source-architecture.md). ## Lyrics Sharing MeiloX integrates [Lyricon Provider](https://tomakino.github.io/lyricon/zh-cn/developer/provider/), [SuperLyricApi](https://github.com/HChenX/SuperLyricApi), and [ColorOS Live Lyrics Bridge](https://github.com/Andrea-lyz/ColorOS-Live-Lyrics-Bridge) to share lyrics, word timings, translations, and playback status. “Enable lyrics sharing” is on by default under Settings → Lyrics Settings → Lyrics Sharing. ## Acknowledgements MeiloX's interface, lyrics, and underlying functionality are inspired by or directly use open-source components from the following projects. Thanks to all contributors: - [Mei](https://github.com/ljyh223/Mei): upstream Android project and core functionality; - [MeloX](https://github.com/youshen2/MeloX): iOS reference implementation and product direction; - [Glasmio](https://github.com/NEORUAA/Glasmio): iOS-style animation and UI library; - [amll-ttml-db](https://github.com/Steve-xmh/amll-ttml-db): word-by-word lyrics data; - [accompanist-lyrics-ui](https://github.com/6xingyv/accompanist-lyrics-ui): lyrics models and rendering components; - [Lyricon](https://github.com/tomakino/lyricon): lyrics provider SDK; - [SuperLyricApi](https://github.com/HChenX/SuperLyricApi): lyrics sharing SDK; - [ColorOS Live Lyrics Bridge](https://github.com/Andrea-lyz/ColorOS-Live-Lyrics-Bridge): ColorOS lock-screen lyrics interface. ## License and Third-Party Notices The main MeiloX code is released under the [GNU General Public License v3](LICENSE). MeiloX is derived from Mei, and upstream code and reference implementations remain subject to their original copyrights and licenses. Third-party libraries, models, scripts, fonts, and visual assets do not automatically become GPLv3-licensed because MeiloX uses GPLv3. Key notices: - Upstream [Mei](https://github.com/ljyh223/Mei) code is licensed under Apache License 2.0; - Relevant reference code from [MeloX](https://github.com/youshen2/MeloX) is subject to that project's GPLv3 terms; - [Glasmio](https://github.com/NEORUAA/Glasmio) is licensed under Apache License 2.0; see [THIRD_PARTY_NOTICES](THIRD_PARTY_NOTICES) for the origins and attribution of retained third-party code; - [amll-ttml-db](https://github.com/Steve-xmh/amll-ttml-db) and [accompanist-lyrics-ui](https://github.com/6xingyv/accompanist-lyrics-ui) follow the licenses and attribution requirements published in their respective repositories; - The BeatNet model, audio fingerprint runtime, ONNX Runtime, PV Tool-derived content, and other distributed components are subject to their respective licenses, copyright notices, and redistribution restrictions. See [THIRD_PARTY_NOTICES](THIRD_PARTY_NOTICES) for complete source, copyright, license, and redistribution details. The `res/font/sf_pro.ttf` font is used solely as a personal project resource. Do not extract or redistribute it separately from build artifacts, and review Apple's font license terms before publicly releasing a build. ## Screenshots
Player screenshot 1 Player screenshot 2 Player screenshot 3 Player screenshot 4
Tablet player screenshot Player screenshot 5
Phone screenshot 1 Phone screenshot 2 Phone screenshot 3 Phone screenshot 4
Phone screenshot 5 Phone screenshot 6 Phone screenshot 7 Phone screenshot 8
Phone screenshot 9 Phone screenshot 10 Phone screenshot 11 Phone screenshot 12
Tablet screenshot 1 Tablet screenshot 2
Tablet screenshot 3 Tablet screenshot 4
## Build from Source Use JDK 21 and Android SDK 37. By default, the latest Glasmio source is built from the sibling `../Glasmio` directory: ```sh git clone https://github.com/NEORUAA/Glasmio.git ../Glasmio ./gradlew :app:assembleDebug ``` To use the latest published Maven package, explicitly disable source substitution: ```sh ./gradlew -Pglasmio.source=false -Pglasmio.version=0.1.3 :app:assembleDebug ``` See the [Glasmio integration guide](docs/glasmio-integration.md) for its renderer, navigation viewport binding, and MiniPlayer native attachment animations. ## Disclaimer This project is intended for learning, research, and personal use only. When using it to access NetEase Cloud Music, comply with local laws, the music service's terms, and applicable copyright requirements. The maintainers are not responsible for third-party service availability, account status, or music content. If you find infringing content, missing license information, or inaccurate third-party notices, please contact the maintainers through [Issues](https://github.com/NEORUAA/MeiloX/issues).
**Made with Jetpack Compose ♥ MeiloX**