# Музыка: 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 → полный скан.