Files
buryan-infra/ops/media/YANDEX-MUSIC.md
T
buryan-agent 56fe8aae4e Яндекс Музыка подключена: 468 лайков, ATL скачан, плейлист в Navidrome
Токен получен, аккаунт Роман Бурьян, Плюс активен. Лайков 468, плейлистов 3,
ATL в лайках 20 треков — скачаны.

Исправления: лайки отдают только id — названия тянутся через /tracks пачками
по 100; файлы скачивались без тегов (Navidrome видел Unknown Artist) —
добавлена запись ID3 через mutagen, для старых файлов retag.py;
инкрементальный скан Navidrome не подхватывал файлы — используется
navidrome scan --full; дубли связей графа — уникальный индекс и
ON CONFLICT DO NOTHING; поиск исполнителя по подстроке давал ложные
попадания (ATL ⊂ Visions Of Atlantis) — сравнение по исполнителю целиком.

Navidrome: 22 трека, 13 альбомов, 6 исполнителей, плейлист «Яндекс — Мне
нравится» на 23 трека. Граф: 13 альбомов, 22 трека, 6 исполнителей.
2026-10-20 14:13:45 +03:00

9.3 KiB
Raw Blame History

Музыка: Navidrome и синхронизация с Яндекс Музыкой

Что было сломано

Navidrome (CT 125, порт 4533, за oauth2-proxy на 9976) был настроен на том /path/to/your/music — заглушку из docker-compose. Библиотека была пуста не потому, что нет музыки, а потому что том не существует.

Ещё одна деталь: /rest/ (Subsonic API) на 9976 отдаёт 302 — его перехватывает oauth2-proxy. Для инструментов нужен прямой порт 4533.

Что исправлено

  1. Музыка хранится на узле: /mnt/media/music → смонтирована в CT 125 как /music (pct set 125 -mp0 /mnt/media/music,mp=/music).
  2. Контейнер пересоздан с -v /music:/music (вместо заглушки).
  3. Проверка: сгенерировал тестовый WAV, Navidrome его импортировал (tracksImported=1), затем удалил.

Теперь музыкальный конвейер живой: положили файл → скан → трек в библиотеке.

Синхронизация с Яндекс Музыкой

/opt/hub-core/yandex_music.py — адаптер к неофициальному API api.music.yandex.net (он доступен с узла, отвечает).

Режим Что делает
--check проверяет токен, показывает аккаунт и наличие Плюса
--likes выгружает «Мне нравится» (метаданные)
--playlists выгружает плейлисты (метаданные)
--m3u собирает M3U-плейлист из треков, которые уже есть локально
--download N скачивает N треков из «Мне нравится» в /mnt/media/music

Токен: /root/.yandex-token (одна строка).

Почему M3U, а не Subsonic API

Пользователи Navidrome создаются через SSO (заголовок X-Forwarded-User) и не имеют пароля, поэтому rest/* с логином/паролем не работает. Navidrome сам импортирует .m3u из папки музыки — это проще и надёжнее: адаптер пишет плейлист, Navidrome подхватывает при сканировании.

Правовая сторона

  • Метаданные («Мне нравится», плейлисты) — это данные владельца подписки, их выгрузка не требует обхода защиты.
  • Скачивание треков доступно только владельцу подписки Плюс и только для личного офлайн-прослушивания. Публикация файлов нарушает условия сервиса.
  • Пиратские торренты для музыки я не подключаю: это нарушение авторских прав, в отличие от фильма общественного достояния, на котором проверялся видеоконвейер.

Как включить

  1. Получить токен Яндекс Музыки (см. ниже) и положить в /root/.yandex-token.
  2. python3 /opt/hub-core/yandex_music.py --check — убедиться, что виден аккаунт и Плюс.
  3. --likes / --playlists — посмотреть, что есть.
  4. --download 10 — скачать первые треки в библиотеку.
  5. --m3u — собрать плейлист из того, что уже есть.
  6. Перезапустить Navidrome (или дождаться скана) — треки и плейлист появятся в music.buryans.ru.

Где взять токен

Токен берётся из браузера, где вы уже вошли в Яндекс Музыку: в localStorage ключ music_token (или через OAuth-приложение Яндекса). Токен даёт доступ к вашему аккаунту, поэтому хранится только на узле с правами 600.

Что дальше

  • Разложить музыку в графе: исполнитель → альбом → трек, связать композиторов фильмов с саундтреками (связь «музыка» уже есть).
  • Синхронизация не только «нравится», но и плейлистов в M3U-файлы.
  • Автообновление: cron раз в сутки — --download новых лайков и пересборка M3U.

Музыка в графе

content_graph.py читает /mnt/media/music по структуре исполнитель/альбом/треки и строит связи:

исполнитель → альбом   «выпустил»
альбом → трек          «содержит»

Проверено на контрольном альбоме: Проверка — Альбом с двумя треками подхватился, затем удалён. Пока библиотека пуста, карточек не появляется.

Связь «музыка» (композитор → фильм) уже есть — когда появятся саундтреки, композиторы сойдутся с альбомами по имени.

Команда «музыка»

**Музыка**

Navidrome: работает
В библиотеке: 0 альбомов, 0 треков
Яндекс Музыка: токена нет (см. YANDEX-MUSIC.md)

Чего я не буду делать

Скачивать ATL (и любую другую защищённую музыку) с торрентов — это нарушение авторских прав. Варианты, которые работают легально:

  1. Яндекс Музыка через ваш токен — --download качает треки из вашего «Мне нравится» для личного офлайн-прослушивания (нужна подписка Плюс).
  2. Купленные файлы — положить в /mnt/media/music в структуре исполнитель/альбом/, дальше всё автоматически: скан, граф, плейлисты.
  3. Свободная музыка — archive.org, Jamendo, Free Music Archive: легально и без подписки.

Подключено и работает

Токен получен, аккаунт Роман Бурьян, Плюс активен, uid 81221846.

«Мне нравится»: 468 треков
Плейлистов: 3 (новый — 29, Распознано — 4, Мой плейлист — 0)
ATL в лайках: 20 треков

Скачано 20 треков ATL + 2 тестовых. Navidrome: 22 трека, 13 альбомов, 6 исполнителей, 1 плейлист «Яндекс — Мне нравится» (23 трека). Граф: 13 альбомов, 22 трека, 6 исполнителей, связи «выпустил» и «содержит».

Что пришлось починить

  1. Лайки отдают только id. /users/{uid}/likes/tracks возвращает {id, albumId, timestamp} без названий. Названия — через /tracks?track-ids=... пачками по 100.
  2. Файлы скачивались без тегов — Navidrome видел «[Unknown Artist]». Добавлена запись ID3 (mutagen) после скачивания; для старых файлов — retag.py, который размечает по структуре папок.
  3. Инкрементальный скан Navidrome не подхватывал новые файлы. Помогает navidrome scan --full — теперь это в cron вместо рестарта.
  4. Дубли связей графа. Добавлен уникальный индекс entity_links(from_id, to_id, relation), вставка — ON CONFLICT DO NOTHING.
  5. Поиск исполнителя по подстроке давал ложные попадания (ATL ⊂ «Visions Of Atlantis»). Теперь сравнение по каждому исполнителю целиком.

Команды

python3 /opt/hub-core/yandex_music.py --check
python3 /opt/hub-core/yandex_music.py --likes          # 468 треков
python3 /opt/hub-core/yandex_music.py --artist ATL     # что есть у ATL
python3 /opt/hub-core/yandex_music.py --download-artist ATL
python3 /opt/hub-core/yandex_music.py --download 5
python3 /opt/hub-core/yandex_music.py --m3u

Важно: запускать через /opt/music-tools/venv/bin/python — там mutagen, иначе файлы скачаются без тегов.

Синхронизация

yandex_sync.sh (cron 05:30): проверка → 5 новых треков → M3U → полный скан.