YumaPlayer README

The project's README from github.com/MuwMx/YumaPlayer. As one markdown file: README.md.

YumaPlayer Icon

YumaPlayer (Yuma)

English Russian

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).

Showcase • Features • Architecture • Download • Contributing • Support

Latest Release GitHub Stars Downloads License: GPLv3 Android 8.0+ Telegram

MuwMx%2FYumaPlayer | Trendshift

🌟 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 18-module architecture, 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

Full Player
Main Player (FLAC & Glass) 		3-Tier Lyrics
3-Tier Synced Lyrics 		Queue Management
Queue (Dual-Sheet & Haptic)
Artist Header
Immersive Artist Poster 		Morphing Collapse
Telegram-Style Morphing 		Home Screen
Home (Quick Picks & YDS)
Spotify Screen
Spotify Feed & Recommendations 		Spotify Radio
Spotify Radio & Mixes 		Spotify Daily
Spotify Daily Mixes

✨ Key Features

🔄 Dual Mode (Spotify + YouTube Music)

🎧 Audiophile Playback & Lossless FLAC

🎤 Synchronized Lyrics & AI Translation

🎨 Yuma Design System (YDS 2.1) & Fluid Motion

🌐 Integrations & Convenience

🌍 Globalization & Localization

YumaPlayer is localized into multiple languages thanks to our amazing community translators. The localization pipeline is continuously synchronized with the codebase via Hosted Weblate.

Translation Status

Detailed Translation Progress

Contribute via Weblate

Want to help translate Yuma? No coding or Git knowledge required. Just open our Weblate translation dashboard, choose your language, and start contributing directly through your browser.

🏛️ Architecture & Tech Stack

YumaPlayer is built as a multi-module Android project following Clean Architecture and Unidirectional Data Flow (UDF) principles:

📖 Detailed Developer Documentation:

📥 Download & Installation

GitHub Releases Telegram Channel Obtainium
Download on GitHub Get on Telegram Add to Obtainium

Building from Source

git clone https://github.com/MuwMx/YumaPlayer.git
cd YumaPlayer
./gradlew assembleRelease
# Built APK will be located at: app/build/outputs/apk/release/

Prerequisites: A recent Android Studio version with AGP 9.x support, JDK 21, Android SDK 37 (compileSdk/targetSdk 37, minSdk 26).

⚙️ Account Setup

YumaPlayer is fully functional out of the box without signing in. Logging in is optional and only required to sync personal playlists, likes, and recommendations:

🎵 Connecting Spotify
  1. Open Settings → Account → Spotify → Tap Log In.
  2. Sign in with your standard Spotify credentials in the secure in-app browser window.
  3. Your session cookie (sp_dc) will be automatically captured and encrypted on your device.
📺 Connecting YouTube Music

Two convenient login methods are supported:

  • Method 1 (Google Account): Open Settings → Account → YouTube → Sign in using the secure in-app authentication sheet.
  • Method 2 (Token / Cookie Input): If you use two-factor authentication or prefer manual setup, navigate to Settings → Account → Token Editor and paste your session cookies directly.

☕ Support the Project

YumaPlayer is free, open source, and has no ads or subscriptions. If you enjoy using the player and wish to support ongoing development:

Support on Ko-fi    Support on Patreon

Solana (SOL, USDT, USDC):
DT3ckdbNuiQMR1mrCpBXCMrhLB19GckVv3YfxsLLiF8z

PayPal / Email Transfer:
[email protected]

📈 Star History

Star History Chart

💡 Contributing

Contributions make open-source projects thrive! Whether you are fixing bugs, proposing new features, or improving docs:

🤝 Acknowledgments (Open-Source Credits)

YumaPlayer is built on the shoulders of the open-source community:

License

YumaPlayer is free software licensed under the GNU General Public License v3.0 (GPLv3).
You may freely copy, modify, and redistribute the source code provided you preserve copyright notices and distribute derivative works under the same GPL-3.0 license.

Disclaimer

YumaPlayer is an independent third-party client. It is not affiliated with, endorsed by, or sponsored by Google LLC, YouTube Music, or Spotify AB. The application is provided for personal use only as a tool for managing your own library.

Crafted with ❤️ and attention to every frame. Enjoy the music! 🎵

YumaPlayer (MuwMx/YumaPlayer)

Searching Database…

857 ·GitHub
YumaPlayer
What is this?YumaPlayer (Yuma) is an independent, open-source Android music player that combines Spotify's discovery/recommendation UI with the YouTube Music library and adds Hi-Res Lossless FLAC streaming, wrapped in a custom glassmorphism design.
Is this an official Spotify or YouTube Music app?No, it is a third-party client built independently, not affiliated with or endorsed by Google, YouTube Music, or Spotify AB.
How do I install and get it running?Download a ready APK from GitHub Releases, the project's Telegram channel, or Obtainium; alternatively build it yourself in Android Studio with AGP 9.x, JDK 21 and Android SDK 37.
Do I need a Spotify or YouTube Music account to use it?No, the app works fully without signing in. Logging in is optional and only needed to sync your personal playlists, likes and recommendations via a captured Spotify session cookie or a Google/token-based YouTube Music login.
Does lossless FLAC streaming always work?Lossless FLAC relies on the Qobuz/QBDLX resolver backbone; if a track isn't available there, playback silently falls back to YouTube Music's high-bitrate Opus/AAC stream instead. Features like Spotify Canvas backgrounds and Shazam-style music recognition are still listed as in development.
Where do my login credentials and listening data go?Everything stays on your device: there is no telemetry, crash reporting or third-party trackers, and credentials are encrypted locally with AES-256-GCM via Google Tink.
What is the Yuma Design System (YDS 2.1)?It's the app's custom visual system: translucent glass cards with thin hairline borders and layered corner geometry, plus a dual-sheet gesture engine where swiping left opens Lyrics and swiping right opens the Queue, animated with a Telegram-style morphing header.
How does the synchronized lyrics feature work?Lyrics are shown in a 3-tier live display (original script, romanization, and translation) with word-by-word karaoke scrolling pulled from 6+ providers like LRCLIB and SimpMusic, and lines can be instantly AI-translated into your preferred language.
Can I listen along with friends in real time?Yes, the 'Together' feature syncs playback between devices over WebSockets, and the app also supports Discord Rich Presence and Last.fm/ListenBrainz scrobbling.
What codebases is YumaPlayer built on?It's a rebuild of ArchiveTune with foundations from Metrolist and SimpMusic, taking queue mechanics from PixelPlayer, Spotify integration ideas from Meld, and FLAC architecture inspiration from Stash.
What are similar projects?Metrolist, vivi-music, LastWave-Native, ArchiveTune, Levyra-deepsound, SimpMusic, BitChord, Echo-Music
Which topics is it in?glassmorphism, lyrics, flac, android-ui, youtube-music, material3, spotify, jetpack-compose, music-player, localization, music, translation
Creator
MuwMx
Size
42 MB
Stars
857
Updated
CommitOct 18Releasev1.2.0-RC.1Oct 17
Age
2mo
Commits · 90 Days