Провайдер Яндекс Музыки для Music Assistant

📖 Documentation / Документация · 🔄 Changelog / Журнал · 🐛 Issues / Проблемы · 💬 Discussions / Обсуждения

Related providers: Yandex Music Connect (Ynison) · Yandex Station · Yandex Smart Home · Yandex Alice

English | Русский

📖 Документация пользователя

Слушайте свою библиотеку Яндекс Музыки через Music Assistant с полной поддержкой навигации, поиска, радио и воспроизведения без потерь.

Быстрый старт (Docker)

# Клонируйте репозиторий
git clone https://github.com/trudenboy/ma-provider-yandex-music.git
cd ma-provider-yandex-music

# Запустите Music Assistant с предустановленным провайдером
docker compose -f docker-compose.dev.yml up

Откройте веб-интерфейс MA по адресу http://localhost:8095, затем перейдите в Настройки → Музыкальные источники → Добавить источник → Яндекс Музыка и введите ваш OAuth-токен.

Подробное руководство по Docker-окружению для разработки: docs/dev-docker.md.

Возможности

• Синхронизация библиотеки — Исполнители, Альбомы, Треки (Понравившиеся), Плейлисты синхронизируются с библиотекой MA
• Редактирование библиотеки — Лайк / дизлайк Исполнителей, Альбомов, Треков прямо из MA
• Навигация — Понравившиеся треки, Радио «Моя волна», Подборки и Миксы (настроение/эпоха/активность/жанр), Лента, Чарт, Исполнители, Альбомы, Плейлисты
• Рекомендации — персональные разделы «Для вас», представленные как папки рекомендаций MA
• Поиск — Треки, Исполнители, Альбомы, Плейлисты
• Похожие треки — на основе станции ротора Яндекса
• Тексты песен — получаются через API Яндекс Музыки
• Качество звука — Экономичное (AAC ~64 кбит/с) / Сбалансированное (AAC ~192 кбит/с) / Высокое (MP3 ~320 кбит/с) / Превосходное (FLAC без потерь, с AES-дешифрованием для encraw-транспорта)
• Радио «Моя волна» — бесконечное персональное радио с обратной связью ротора и постраничной навигацией
• Мультиаккаунт — одновременное подключение нескольких аккаунтов Яндекс Музыки

Документация

Руководство	Описание
Настройка	Токен, качество, «Моя волна», настройки понравившихся треков
Разработка	Настройка окружения, тесты, линтинг, формат коммитов
Участие в разработке	Сообщения об ошибках, предложения, pull request'ы
Тестирование	Запуск тестов, CI-пайплайн, покрытие
Управление инцидентами	Метки, автоматическое отслеживание, триаж Copilot
Локальная разработка (Docker)	Запуск MA + провайдера без установки зависимостей

Ссылки

• Music Assistant — open-source музыкальный сервер от Marcel van der Veldt
• Яндекс Музыка — стриминговый сервис от Яндекса

Референсные проекты

• MarshalX/yandex-music-api — неофициальный Python-клиент Яндекс Музыки (используется как зависимость)
• chernyshalexander/YandexMusicLMS — плагин Яндекс Музыки для Lyrion Music Server
• DECE2183/yamusic-tui — терминальный клиент Яндекс Музыки
• music-assistant/server — ядро Music Assistant

Благодарности

• @peholod009 — за помощь в тестировании и обратную связь
• @alkmarmasor — за идеи и наработки в форке провайдера

Лицензия

Apache 2.0 — история изменений в CHANGELOG.md.