Estrella Music v2

Cross-platform music player & streaming · Flutter · Music Provider Architecture

✨ What is Estrella Music v2?

Estrella Music v2 is the full Flutter evolution of the original Kotlin version. Built around a modular MusicProvider architecture, v2 delivers a 100% functional local playback experience alongside online cloud streaming powered by EMusic and identity by Joss Red across Android, Windows, Linux, macOS, and iOS.

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

🚀 Features

🎵 Streaming & Playback

Local audio playback & rich online streaming via modular providers
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 management & import
Persistent playback queue

☁️ Cloud & Sync (EMusic)

Cloud library sync via EMusic server
Device-local offline downloads
Conflict-free incremental sync with queue
Multi-device support with Joss Red identity

🖥️ Cross-Platform

Native desktop & mobile experience

🔐 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
Architecture	Modular `MusicProvider` (`LocalMusicProvider`, `EMusicProvider`)
State	GetX
Audio (Android/iOS)	`just_audio`
Audio (Desktop)	`media_kit` via `just_audio_media_kit`
Networking	Dio
Database	Hive (Local state & profiles) · SQLite (EMusic sync & outbox)
Auth & Identity	Joss Red (JWT · profile · backups · friends)
Cloud Music	EMusic (catalog orchestrator · playlists · sync)
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 external music services. All trademarks belong to their respective owners.

📈 Growth

Made with ❤️ by JOSPROX

Name		Name	Last commit message	Last commit date
.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
devtools_options.yaml		devtools_options.yaml
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?