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

172 lines
9.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Музыка: 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»). Теперь сравнение по каждому исполнителю
целиком.
## Команды
```bash
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 → полный скан.