# [MeiloX](https://github.com/NEORUAA/MeiloX)

### A multi-source Android music client based on Mei, inspired by the Apple Music design




---
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