Токен получен, аккаунт Роман Бурьян, Плюс активен. Лайков 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 исполнителей.
172 lines
9.3 KiB
Markdown
172 lines
9.3 KiB
Markdown
# Музыка: 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 → полный скан.
|