Important
ZenMusic is still in development. Features may change and you may run into bugs. Updates are delivered through GitHub Releases.
Note
Regional availability - If YouTube Music or JioSaavn is unavailable in your region, that source may not work without a VPN or proxy connecting to a supported region.
|
|
|
|
|
|
ZenMusic targets Android only.
git clone https://github.com/vorlon-dev/Zen-music.git
cd Zen-music
flutter pub get
flutter run # with a connected Android device or emulatorRelease APKs (what the download badges serve):
flutter build apk --release --split-per-abi # per-ABI splits
flutter build apk --release # universal APKIf no keystore is configured, release builds fall back to debug signing so the build still works. Use your own release keystore for any APK you distribute, because Android only installs updates signed with the same key.
- Fork the repository.
- Create a branch for your change:
git checkout -b feature/my-feature
- Make your changes and commit with a clear message.
- Push to your fork and open a Pull Request describing what changed and why.
Please keep pull requests focused on a single change, and test on a real device before submitting.
| Project | Contribution |
|---|---|
| Echo nightly | Extension implementation |
| Echo music | UI design language, Listen Together client, recognition engine, Apple Music canvas and welcome dialog |
| Metrolist / metroserver | Listen Together server protocol and deployment |
| Musify | Streaming and app architecture reference |
| Project | Contribution |
|---|---|
youtube_explode_dart / yt_extractor |
YouTube stream extraction |
audio_service / just_audio |
Playback engine |
flutter_lyric |
Lyrics rendering |
| LRCLIB | Synced lyrics provider |
| Shazam discovery API / dejavu-fingerprinter | Song recognition |
| Music Recognizer | Recognition flow reference |
ZenMusic is a fully open-source project created for educational purposes and personal use. It is not monetized in any way: there are no advertisements, premium features or subscriptions.
The app acts strictly as a client to publicly available content and APIs of the platforms it supports. We do not host, upload, distribute or store any audio, video or copyrighted media files. All content is served by the respective platforms and remains the property of its copyright owners.
This project is not affiliated with, authorized, or endorsed by YouTube, Google LLC, JioSaavn, or any of their affiliates. All trademarks and intellectual property rights belong to their respective owners.
This software is provided "AS IS", without warranty of any kind. Users are solely responsible for ensuring their usage complies with their local copyright laws and the Terms of Service of the platforms they access.
Licensed under GPL-3.0
Made with ❤️ by vorlon-dev