Настройка

Аутентификация устроена так же, как во встроенном провайдере Google Drive: вы регистрируете собственное OAuth-приложение Яндекса и авторизуете Music Assistant в нём. Дальше Music Assistant сам поддерживает access-токен свежим через refresh-токен. Redirect URI регистрировать не нужно — Яндекс показывает код подтверждения, который вы просто вставляете в форму.

1. Зарегистрируйте OAuth-приложение Яндекса (один раз)

1. Откройте https://oauth.yandex.ru/ и создайте приложение («для доступа к API»).
2. В разделе Доступ к данным добавьте право cloud_api:disk.read.
3. Скопируйте ClientID и Client secret приложения.

Redirect URI оставьте яндексовский по умолчанию (https://oauth.yandex.ru/verification_code) — настраивать его не нужно.

2. Добавьте провайдер

1. В Music Assistant: Настройки → Источники музыки → Добавить → Yandex Disk.
2. Вставьте Client ID и Client Secret.
3. Перейдите по ссылке в поле Confirmation code, разрешите доступ и скопируйте код, который покажет Яндекс.
4. Вставьте код в поле Confirmation code и нажмите Authorize — провайдер обменяет его на refresh-токен и сохранит автоматически.
5. Укажите корневую папку для сканирования (например, disk:/Music; disk:/ сканирует весь диск).
6. Выберите тип контента (музыка / аудиокниги / подкасты) — задаётся только при первичной настройке.

Почему нужно своё приложение?

У Яндекса нет API для программного создания OAuth-приложений и нет проверенного публичного first-party клиента, выдающего токены для Диска. WebDAV (логин + пароль приложения) обошёлся бы без своего приложения, но требует платной подписки Яндекс 360. Личное OAuth-приложение (бесплатное) с read-only-скоупом Диска — та же модель, что у провайдера Google Drive, и она работает на бесплатных аккаунтах.

Стриминг и перемотка

Файлы стримятся через собственный прокси-маршрут Music Assistant: на каждое воспроизведение запрашивается свежая подписанная ссылка на скачивание, а HTTP-заголовок Range пробрасывается дальше — поэтому перемотка работает даже в длинных аудиокнигах.

Примечания

• Провайдер работает только на чтение — он никогда не пишет на ваш Яндекс Диск.
• Access-токен обновляется автоматически; повторная авторизация нужна, только если вы отзовёте доступ или удалите приложение.
• Списки папок кэшируются на 5 минут; синхронизация библиотеки всегда запрашивает свежие списки. Изменения файлов определяются по их md5.