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

English | Русский

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

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

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

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

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

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

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

Возможности

• Синхронизация библиотеки — Исполнители, Альбомы, Треки (Понравившиеся), Плейлисты синхронизируются с библиотекой MA
• Редактирование библиотеки — Лайк / дизлайк Исполнителей, Альбомов, Треков прямо из MA
• Навигация — Понравившиеся треки, Мой Микс, Исполнители, Альбомы, Плейлисты
• Рекомендации — Мой Микс представлен как папка рекомендаций MA
• Поиск — Треки, Исполнители, Альбомы, Плейлисты
• Похожие треки — на основе ротора KION
• Качество звука — Высокое (MP3 320 кбит/с) / Без потерь (FLAC)

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

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

Ссылки

• Music Assistant — open-source музыкальный сервер от Marcel van der Veldt
• KION Музыка — стриминговый сервис от МТС
• yandex-music — неофициальный Python-клиент от MarshalX

Лицензия

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