Estrella Music v2

Cross-platform music streaming · Flutter · YouTube Music

✨ What is Estrella Music v2?

Estrella Music v2 is the full Flutter evolution of the original Kotlin version. Built on top of a powerful engine and deeply integrated with the YouTube Music ecosystem, v2 brings a premium cross-platform experience to Android, Windows, Linux, macOS, and iOS — with cloud sync powered by EMusic and identity by Joss Red.

Migrate seamlessly from your old song.db or .backup files. Your playlists, history, and favorites come with you.

🚀 Features

🎵 Streaming & Playback

Stream millions of songs, albums & playlists via YouTube Music
High-quality audio with smart chunk caching
Gapless playback & skip silence
Background playback with native media controls
Radio / continuous discovery mode

📜 Library & Discovery

Local library management (songs, albums, artists)
Synced & plain-text lyrics via LRCLIB
Playlist import (YouTube Music, Piped)
Persistent playback queue

☁️ Cloud & Sync (EMusic)

Cloud library sync via EMusic server
Offline downloads with authorized metadata
Conflict-free incremental sync with queue
Multi-device support with Joss Red identity

🖥️ Cross-Platform

Android — Material 3 UI + Android Auto
Windows & Linux — Desktop sidebar + tray
macOS — Native macOS window management
iOS — Unsigned IPA via SideStore

🔐 Auth & Updates

Identity via Joss Red (JWT · profile · backups · friends)
In-app updater with per-platform download & install
Blocking update gate with world-class UI

📸 Screenshots

Library, Wrap & Stats Screens (from the Kotlin version)

🛠 Tech Stack

Layer	Technology
Framework	Flutter 3.x · Dart
State	GetX
Audio (Android/iOS)	`just_audio`
Audio (Desktop)	`media_kit` via `just_audio_media_kit`
Networking	Dio · YouTube Explode
Database	SQLite (`sqlite3`) with legacy Hive migration
Auth & Identity	Joss Red (JWT · profile · backups · friends)
Cloud Music	EMusic (playlists · sync · offline · history)
Notifications	`flutter_local_notifications` · Firebase Messaging
Build & Release	GitHub Actions — multi-platform · draft releases

📥 Installation

Android / Windows / Linux / macOS

Download the latest release for your platform:

Platform	File	Notes
🤖 Android	`EstrellaMusic-android-universal.apk`	Universal APK — also available split by ABI
🪟 Windows	`EstrellaMusic-windows-installer.exe`	Inno Setup installer
🐧 Linux	`EstrellaMusic-linux-x64.tar.gz`	Requires `libmpv` + `libgtk-3`
🍎 macOS	`EstrellaMusic-macos.zip`	Extract & drag to Applications. If Gatekeeper blocks it: right-click → Open
🐙 All	GitHub Releases →

The in-app updater will notify you and handle download + installation automatically on Android and Windows.

🍏 iPhone / iOS — Automatic Signing with SideStore

To install the .ipa without the signature expiring after 7 days:

Install SideStore by following the official guide at sidestore.io (requires initial computer setup + internal WireGuard VPN).
Configure EMusic Anisette Server:
- SideStore → Settings → Anisette Server URL
- Replace with: https://emusic.joss.red/api/anisette
- Log in with your Apple ID inside SideStore.
Install the App:
- Download EstrellaMusic-ios-unsigned.ipa on your iPhone → Files.
- SideStore → My Apps → + → select the .ipa file.
Auto-renewal: Open SideStore on Wi-Fi once a week and the signatures will renew in the background.

🧑‍💻 Build from source

# 1. Clone
git clone https://github.com/josprox/Estrella-Music.git
cd Estrella-Music

# 2. Environment
cp .env.example .env
# Edit .env — set API_URL, ONESIGNAL_APP_ID, UPDATE_CHECK_URL

# 3. Dependencies
flutter pub get

# 4. Run
flutter run

☁️ Architecture — Joss Ecosystem

┌────────────────────┐     JWT      ┌──────────────────┐
│   Estrella Music   │ ──────────► │    Joss Red      │
│  (Flutter Client)  │             │  Identity · Auth  │
│                    │             │  Profile · Backup │
│  Local cache       │             └──────────────────┘
│  Offline playback  │
│  Smart sync queue  │    Music     ┌──────────────────┐
│                    │ ──────────► │     EMusic       │
└────────────────────┘             │  Playlists · Sync │
                                   │  History · Cloud  │
                                   └──────────────────┘

Joss Red — source of truth for users, sessions, JWT, profile, friends and backups.
EMusic — specialized music cloud service (library, playlists, favorites, offline metadata, sync).
Flutter app — primary client that works fully offline and syncs when connected.

📜 License & Authorship

Licensed under the GNU General Public License v3.0.

You may not use modified versions for non-free or commercial purposes.
You may not publish modified versions on closed-source stores (Google Play, App Store).
See CREDITS.md for full third-party acknowledgments.

This project is not affiliated with, funded, authorized, or endorsed by Google LLC or YouTube. All trademarks belong to their respective owners.

📈 Growth

Made with ❤️ by JOSPROX

Name		Name	Last commit message	Last commit date
Latest commit History 1,356 Commits
.github		.github
android		android
assets		assets
distribution		distribution
docs		docs
fastlane/metadata/android		fastlane/metadata/android
ios		ios
lib		lib
linux		linux
macos		macos
test		test
tools		tools
web		web
win_cert		win_cert
windows		windows
.env.example		.env.example
.gitignore		.gitignore
.gitmodules		.gitmodules
.metadata		.metadata
AGENTS.md		AGENTS.md
CREDITS.md		CREDITS.md
LICENSE		LICENSE
README.md		README.md
analysis_options.yaml		analysis_options.yaml
cover.png		cover.png
flutter_launcher_icons.yaml		flutter_launcher_icons.yaml
flutter_native_splash.yaml		flutter_native_splash.yaml
icon.png		icon.png
playlist_placeholder.png		playlist_placeholder.png
pubspec.lock		pubspec.lock
pubspec.yaml		pubspec.yaml

Navigation Menu

Repository files navigation

Estrella Music v2

✨ What is Estrella Music v2?