MuwMx / YumaPlayer

YumaPlayer (Yuma) 
 A hybrid music client for Android focused on usability, clean aesthetics, and audiophile-grade sound. 
 Spotify UI + Discovery Algorithms + YouTube Music Library + Hi-Res Lossless (FLAC) + Smart Automix. 
 Showcase •
 Features •
 Architecture •
 Download •
 Contributing •
 Support 
---
## 🌟 About the Project
**YumaPlayer** is an independent, open-source Android music player that unites the libraries and recommendation features of two leading streaming services alongside standalone local playback in Hi-Res quality.
The project evolved as a comprehensive rebuild of **ArchiveTune** (with foundations from **Metrolist** and **SimpMusic**), inspired by **PixelPlayer's** queue mechanics, **Meld's** Spotify integration pipeline, and **Stash's** FLAC architecture. On top of this base, YumaPlayer implements a modular 20-module architecture, a dedicated low-level audio DSP engine, the custom **YDS 2.1** design system, and hardware-accelerated fluid gesture physics.
No subscriptions. No advertisements. Zero telemetry, crash reporters, or third-party trackers. All credentials live exclusively on your device, encrypted with AES-256-GCM via Google Tink, and the codebase is completely open under the GNU General Public License v3.0.
---
## 📸 Showcase
 Main Player (FLAC & Glass) 
 3-Tier Synced Lyrics 
 Queue 
 Immersive Artist Poster 
 Telegram-Style Morphing 
 Home (Quick Picks & YDS) 
 Spotify Feed & Recommendations 
 Spotify Radio & Mixes 
 Spotify Daily Mixes 
---
## ✨ Key Features
### 🎛️ Audio Engine & Smart Automix 
- **Dual-Deck Continuous Crossfade:** True gapless and overlapping playback using two independent, synchronized audio deck controllers with atomic role swapping. Zero silence between tracks.
- **DJ Transition Intelligence:** Automated outro/intro cue detection, energy cliff analysis, BPM matching, and complementary bass-swap filters (0.45–0.55 window).
- **Audiophile Codec Pipeline:** Dedicated 24-bit packed PCM processing, Kopus-first Opus decoding with MediaCodec fallback, and native FLAC length resolution.
- **Smart Stall Recovery:** Automatic degradation to hard cut on buffer underruns, automated stream revival upon network reconnection, and strict source-scoped cache identities.
- **N+1 Prefetching:** Seamless background caching of upcoming tracks into the local download cache.
### 🔄 Dual Mode (Spotify + YouTube Music)
- **Spotify Catalog:** In-app browsing of Spotify albums, Daily Mixes, Discover Weekly, and playlists with cross-script deduplication and locale-aware metadata.
- **YouTube Music Catalog:** Full-catalog search across YouTube Music, charts, mood & genre categories, radio stations, and fast channel switching.
- **SponsorBlock Integration:** Configurable in-app segment skipping for sponsor messages, music hooks, fillers, and subscription reminders.
### 🎧 Lossless Playback & Local Audio
- **Lossless FLAC:** Stream and download true lossless FLAC tracks (via Qobuz / QBDLX backbone integration) using your own cr