YumaPlayer (Yuma)

Гибридный музыкальный плеер для Android с акцентом на удобство, дизайн и качественный звук.
Spotify UI + Алгоритмы рекомендаций + База YouTube Music + Hi-Res Lossless (FLAC).

Скриншоты • Возможности • Архитектура • Скачать • Внести вклад • Донат

--- ## 🌟 О проекте **YumaPlayer** — это независимый открытый музыкальный плеер для Android, объединяющий каталоги и функции двух ведущих платформ со стримингом и воспроизведением локальных треков в Hi-Res качестве. Проект вырос как глубокая переработка **ArchiveTune** (с наработками от **Metrolist** и **SimpMusic**), вдохновлен механикой очередей **PixelPlayer**, сетевым взаимодействием со Spotify из **Meld** и стримингом FLAC из **Stash**. На этом фундаменте создана модульная архитектура из 18 модулей, собственная дизайн-система **YDS 2.1** и плавная жестовая модель с аппаратным ускорением. Никаких платных подписок, встроенной рекламы, аналитики и закрытых трекеров. Учетные данные шифруются локально на устройстве (AES-256-GCM via Google Tink), а исходный код полностью открыт под лицензией GPL-3.0. --- ## 📸 Галерея интерфейса (Showcase)

_{Главный плеер (FLAC & Glass)}	_{Синхронная 3-уровневая Лирика}	_{Очередь (Dual-Sheet & Haptic)}
_{Иммерсивный постер артиста}	_{Telegram-морфинг в каплю}	_{Главная (Quick Picks & YDS)}
_{Spotify Feed & Рекомендации}	_{Spotify Radio & Подборки}	_{Spotify Daily Mixes}

--- ## ✨ Основные возможности ### 🔄 Два режима работы (Spotify + YouTube Music) * **Spotify Home:** Персонализированный фид рекомендаций, миксы дня (Daily Mixes), Discover Weekly, подборки любимых исполнителей и прямой импорт ваших плейлистов/лайков из Spotify. * **YouTube Music Home:** Классический поиск по всей базе YT Music, чарты, тематические подборки, радиостанции и быстрое переключение каналов. ### 🎧 Аудиофильский звук, FLAC и Воспроизведение * **Lossless FLAC:** Стриминг и загрузка треков в формате FLAC (через Qobuz / QBDLX бэкбон) с указанием личного токена или публичных резолверов. * **Бесшовный фоллбэк:** При отсутствии Lossless-версии трек гладко воспроизводится из YouTube Music (Opus / AAC). * **Локальная музыка:** Полноценный встроенный плеер для аудиофайлов на памяти телефона (FLAC, MP3, AAC, OGG, WAV). * **Оффлайн и Кэш:** Автоматическое кэширование прослушанных треков из YouTube Music для автономного прослушивания без интернета *(кэширование FLAC в активной разработке)*. * **Тонкая настройка звука:** Встроенный 5-полосный эквалайзер + поддержка системных аудиоэффектов, нормализация громкости (EBU R128), плавный кроссфейд, изменение темпа и тональности, таймер сна. ### 🎤 Продвинутая Лирика и AI-перевод * **3-уровневый синхрон:** Одновременный показ оригинального текста (Кандзи/Хангыль), транслитерации (Ромадзи) и перевода на русский язык. * **Караоке-скролл:** Точная синхронизация по времени через 6+ провайдеров (LRCLIB, Kugou, BetterLyrics, SimpMusic, Unison, YouLyPlus). * **AI-перевод на лету:** Мгновенный перевод текста песен прямо во время воспроизведения. * **Карточки цитат:** Возможность сохранить фрагмент текста как стильную картинку для соцсетей. ### 🎨 Yuma Design System (YDS 2.1) и Плавность * **Стеклянный интерфейс (Glass UI):** Полупрозрачные карточки (`GlassScaffold`, тонкие рамки 0.5dp, выверенная геометрия скруглений 22dp / 5dp). * **Dual-Sheet жесты:** Независимые шторки плеера (свайп слева — Текст песни, свайп справа — Очередь) без конфликтов жестов и тряски списков. * **Telegram Morphing Header:** Плавное сжатие постера артиста или альбома в аккуратную каплю в строке состояния при скролле без растягивания картинки. * **Smart Freeze & Pre-warming:** Экраны открываются мгновенно, а невидимые анимации и фоновые процессы засыпают при сворачивании, сохраняя заряд аккумулятора и прохладу устройства. * **Динамический Monet:** Адаптивная генерация темы и акцентов на основе палитры текущей обложки трека. ### 🌐 Интеграции и Удобство * **Spotify Canvas & Apple Motion:** Зацикленные видео-фоны во время воспроизведения *(в разработке)*. * **Распознавание музыки (Shazam):** Встроенный поиск играющего рядом трека по акустическому отпечатку *(в разработке)*. * **Together (Совместное прослушивание):** Синхронное прослушивание музыки с друзьями через WebSockets. * **Скробблинг:** Нативная поддержка Last.fm и ListenBrainz. * **Discord Rich Presence:** Отображение играющего трека в статусе профиля Discord. * **Android Auto & Виджеты:** Поддержка воспроизведения в автомобиле и виджеты на рабочем столе (Glance). --- ## 🌍 Локализация (Globalization) YumaPlayer переведен на множество языков благодаря помощи сообщества. Процесс перевода непрерывно синхронизируется с репозиторием через платформу [Hosted Weblate](https://hosted.weblate.org/).

> **Хотите помочь перевести Yuma?** Знания Git и программирования не нужны. Просто откройте [панель перевода на Weblate](https://hosted.weblate.org/engage/yumaplayer/), выберите язык и вносите правки прямо через браузер. --- ## 🏛️ Архитектура и Технологический стек YumaPlayer — многомодульный Android-проект, построенный по канонам Clean Architecture и однонаправленного потока данных (UDF): * **UI и Дизайн:** Jetpack Compose, дизайн-токены YDS 2.1, аппаратно-ускоренные Haze-оверлеи, плавная жестовая физика. * **Аудиодвижок:** Media3 (ExoPlayer), автономный конвейер локального аудио, Qobuz/FLAC resolver бэкбон. * **Данные и Хранилище:** Room ORM, шифрованные защищенные настройки (AES-256-GCM via Google Tink). * **Сеть и Прием данных:** Ktor/Retrofit, InnerTube (движок YouTube Music), собственные многоисточниковые скраперы лирики. 📖 **Подробная документация для разработчиков:** * [Обзор архитектуры и граф модулей](docs/architecture/ARCHITECTURE.md) * [Архитектурные решения (ADR)](docs/architecture/DECISIONS.md) * [Спецификация дизайн-системы (YDS 2.1)](docs/design/YDS.md) * [Стандарты кода и правила](docs/development/YUMA_RULES.md) --- ## 📥 Установка и Загрузка

GitHub Releases	Telegram Channel	Obtainium

### Сборка из исходников ```bash git clone https://github.com/MuwMx/YumaPlayer.git cd YumaPlayer ./gradlew assembleRelease # Готовый APK появится в: app/build/outputs/apk/release/ ``` *Требования:* свежая версия Android Studio с поддержкой AGP 9.x, JDK 21, Android SDK 37 (compileSdk/targetSdk 37, minSdk 26). --- ## ⚙️ Подключение аккаунтов YumaPlayer полностью функционален без логина. Авторизация нужна только для подтягивания ваших личных плейлистов и рекомендаций:

🎵 Подключение Spotify

1. Откройте **Настройки** → **Аккаунт** → **Spotify** → Нажмите **Войти**. 2. Авторизуйтесь под своими учетными данными на открывшейся веб-странице. 3. Сессия будет автоматически сохранена и зашифрована на устройстве.

📺 Подключение YouTube Music

Доступно два удобных способа входа: * **Способ 1 (Google Аккаунт):** Откройте **Настройки** → **Аккаунт** → **YouTube** → войдите через встроенное безопасное окно авторизации. * **Способ 2 (Ввод токена / Cookie):** Если у вас включена двухфакторная аутентификация или не открывается браузер — перейдите в **Настройки** → **Аккаунт** → **Редактор токенов** и вставьте актуальные cookie сессии вручную.

--- ## ☕ Поддержать проект (Support) YumaPlayer распространяется бесплатно, не содержит рекламы и не продает подписки. Если плеер вам понравился и вы хотите поддержать автора:

Solana (SOL, USDT, USDC):
DT3ckdbNuiQMR1mrCpBXCMrhLB19GckVv3YfxsLLiF8z

PayPal / Email Transfer:
muwmix.coffee@gmail.com

--- ## 📈 История звезд

--- ## 💡 Участие в разработке Мы рады любому вкладу сообщества — от исправления багов до предложений новых функций: * Ознакомьтесь с **[Правилами участия](CONTRIBUTING.md)** перед отправкой кода или созданием Pull Request. * Хотите перевести плеер? Переходите сразу на **[Hosted Weblate](https://hosted.weblate.org/engage/yumaplayer/)** — знание Git не требуется. ### 👥 Контрибьюторы

--- ## 🤝 Благодарности (Open-Source Credits) Проект создан благодаря наработкам и свободному коду сообщества: * **[ArchiveTune](https://github.com/rukamori/ArchiveTune)** — за отличный фундамент, плеерные наработки и базу настроек. * **[Meld](https://github.com/FrancescoGrazioso/Meld)** — за концепцию и реализацию гибридного взаимодействия со Spotify. * **[Stash](https://github.com/rawnaldclark/Stash)** — за вдохновение в организации Lossless FLAC стриминга и загрузок. * **[Metrolist](https://github.com/mostafaalagamy/Metrolist)** & **[SimpMusic](https://github.com/maxrave-dev/SimpMusic)** — за первоначальные парсеры текстов и интерфейсные идеи. * **[PixelPlayer](https://github.com/theovilardo/PixelPlayer)** — за идеи кинематики жестов и организацию очереди. * **[QBDLX](https://github.com/ImAiiR/QobuzDownloaderX)** — за инфраструктуру прямого Lossless аудио. * **[LRCLIB](https://lrclib.net/)** & **[BetterLyrics](https://better-lyrics.boidu.dev/)** — за открытую базу синхронизированной лирики. --- ## ⚖️ Лицензия и Отказ от ответственности ### Лицензия YumaPlayer распространяется под свободной лицензией **GNU General Public License v3.0 (GPLv3)**. Вы можете свободно использовать, изучать, модифицировать и распространять код при условии сохранения авторских прав и открытия производного кода под аналогичной лицензией GPL-3.0. ### Отказ от ответственности (Disclaimer) YumaPlayer — это независимый неофициальный сторонний клиент. Проект **не связан с Google LLC, YouTube Music или Spotify AB** и не одобрен ими. Приложение создано исключительно для личного использования и управления собственной медиатекой. ---

Разработано с ❤️ и вниманием к каждому кадру. Enjoy the music! 🎵