MuwMx /YumaPlayer

🎵 Hybrid music client for Android: Spotify discovery & UI + YouTube Music library + Hi-Res Lossless (FLAC) streaming with fluid Glassmorphism💫

★ 1,239⑂ 56👁 18⑃ 57● 125▤ 6
KotlinGPL-3.0Created 2026-07-24
下载:v1.2.0-RC.2v1.2.0-RC.2 ↓22026-11-13
+25
日增长
1,239
stars
56
forks
18
watchers
57
prs
125
issues
6
releases

README

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
      
    
  


---



 🎬 Feature Walkthrough

https://github.com/user-attachments/assets/d363db0c-522b-4694-bd19-0dd9155ca240


---

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

Top issues

Latest release

v1.2.0-RC.2 v1.2.0-RC.2 2026-11-13
🚀 YumaPlayer v1.2.0-RC.2 is finally here! 🎉

After a month of heavy refactoring, late-night debugging, and massive help from our contributors, RC.2 is ready. This update overhauls Spotify playlist reliability, moves crossfade DSP and DJ filtering to native C++, switches signature decryption to QuickJS by default, and brings an experimental visual refresh with way better battery life.

 Features
- 🎛️ Native C++ Crossfade & DJ Filter: Rewrote the crossfade engine in native C++ and integrated a built-in DJ filter for ultra-fast, 100% reliable track transitions.
- 📝 Editable Spotify Copies: 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON