[2026-09-27] eagle: family/how-to/navidrome-truenas-android.md family/plans/music-jellyfin-lidarr-taiga.md personal/tech/jellyfin-music-library-pitfalls.md personal/tech/jellyfin-tags-cp1251-unreadable.md

This commit is contained in:
Alexey Martemyanov committed 2026-09-27 10:36:34 +06:00
1 parent 43ac43aae0
commit 01c7fe6d03
4 files changed
+478 -25

No files matched your search

+37 -3
View File
@@ -15,7 +15,7 @@
| Источник имени артиста | **имя папки** перекрывает тег | **только тег** |
| Структура папок | требуется `Artist/Album/Track` | **игнорируется полностью** |
| Наша структура `категория/подпапка/файл` | ломает навигацию | **работает как есть** |
| Интернет-метаданные артистов | тянет из MusicBrainz → левые артисты (`Maria Makarova (organ)`) | **не тянет** |
| Интернет-метаданные артистов | тянет из MusicBrainz → левые артисты | **не тянет** |
| Пишет в файлы | может | **никогда** (by design) |
**Официальная дока Navidrome (Tagging Guidelines), прямая цитата:**
@@ -66,13 +66,47 @@
⚠️ **Но выявлен новый пробел:** в файлах **отсутствует `TPE2` (albumartist)** — проверено
`154/154`. Его **не было в плане правок** (`tag-fix-plan.csv` не содержит колонки `album_artist`).
Navidrome строит **альбомы** по `AlbumArtist`; артисты будут правильные и без него,
но альбомы могут склеиваться. **Желательно добавить `TPE2` перед запуском.**
### ✅ `ALBUMARTIST` для Navidrome — НЕ обязателен (проверено 2026-09-27)
**Не блокирует запуск.** Мейнтейнер Navidrome `deluan` (обсуждение #5924):
> «when an album artist tag is missing, Navidrome substitutes the **track artist** in its place»
| Ситуация | Результат |
|---|---|
| `ALBUMARTIST` у всех треков | 1 альбом ✅ |
| Нет `ALBUMARTIST`, сольный альбом | 1 альбом ✅ |
| Нет `ALBUMARTIST`, 4 фита | **5 альбомов** вместо 1 ❌ |
| Нет `ALBUMARTIST`, сборник 18 треков | **до 18 альбомов** ❌ |
**Обход без правки файлов — конфиг:**
```toml
PID.Album = "musicbrainz_albumid|albumartist,album,albumversion,releasedate"
```
> 🔑 Сырое `albumartist`, **НЕ** `albumartistid` (тот никогда не пуст). `folder` в спеку
> класть нельзя. ⚠️ Смена `PID.Album` → полный рескан + новые ID → **бэкапить `navidrome.db`**.
### ✅ Новые закачки тегирует Lidarr сам
Lidarr матчит по MusicBrainz release groups и пишет полные теги, **включая `Album Artist`**
(действие `Write Metadata Tags`). Связка [`navidrome-lidarr-bridge`](https://github.com/danielbanariba/navidrome-lidarr-bridge)
— закачанное Lidarr'ом подхватывается Navidrome автоматически.
### ⚠️ Что реально стоит починить до запуска: СЕМАНТИКА `artist`
Файлы `!Классика` содержат **семантически мусорные** `artist` — формально валидные теги:
```
artist=Классика в современной обработке ← это не артист
artist=Классика для детей П.И. Чайковский ← это не артист
artist=Maria Makarova (organ) ← исполнитель вместо композитора
```
**Navidrome покажет их как артистов** — надо смотреть и чистить.
Детали — [[personal/tech/jellyfin-tags-cp1251-unreadable]] §ИНВЕНТАРИЗАЦИЯ.
## Следующие шаги
- [x] ~~Сначала: ремонт тегов 7906 файлов~~ → ✅ выполнен (волна 38)
- [ ] **Аудит семантики `artist`** — убрать «Классика в современной обработке» и подобное
- [ ] **Опционально:** добавить `TPE2` = `TPE1` (нужен НОВЫЙ план правок с колонкой `album_artist`)
- [ ] Поднять Navidrome в Docker на TrueNAS
- [ ] Пробросить порт / настроить Caddy subdomain (Caddyfile root-owned → через alpine-контейнер)
+95 -13
View File
@@ -1,19 +1,101 @@
# Music → Jellyfin + Lidarr на Тайге — план (v6, 2026-09-27)
# Music → Jellyfin + Lidarr на Тайге — план (v7, 2026-09-27)
> ✅ **СТАТУС v6: ОТКАТ ЗАВЕРШЁН И ПОДТВЕРЖДЁН.** БД Jellyfin восстановлена на версию до импорта
> музыки. Итог: 6 библиотек, Audio=0, MusicArtist=0, Music отсутствует. Jellyfin работает.
> **MD5 внутри контейнера = `b71b5d659a1262fa98b85a6ab0003f24`** — совпал с бэкапом.
> Задача Lidarr — **не начата, отложена** (Alex не возвращался к ней после отката).
> ✅ **СТАТУС v7: JELLYFIN ОТКАЧЕН И СТАБИЛЕН. КУРС СМЕНЁН НА NAVIDROME.**
> БД Jellyfin восстановлена на версию до импорта музыки: 6 библиотек, Audio=0, MusicArtist=0.
> **MD5 `b71b5d659a1262fa98b85a6ab0003f24`** — совпал с бэкапом.
>
> 🔴 **ГЛАВНОЕ ОТКРЫТИЕ v6: поведение Jellyfin — это ОФИЦИАЛЬНО ПОДТВЕРЖДЁННЫЙ БАГ
> [`jellyfin/jellyfin#18162`](https://github.com/jellyfin/jellyfin/issues/18162), а НЕ проблема
> наших тегов.** Jellyfin берёт имя артиста **из имени папки**, перекрывая теги. Гипотеза
> «в файлах нет `TPE2`» **смягчена**: `TPE2` отсутствует у 154/154 (факт), но баг перекрывает
> теги именем папки **даже при валидном `ALBUMARTIST`**.
> 🔀 **РЕШЕНИЕ СЕССИИ: Jellyfin для музыки НЕПРИГОДЕН — ставим Navidrome.**
> Причина — подтверждённый баг [`jellyfin/jellyfin#18162`](https://github.com/jellyfin/jellyfin/issues/18162)
> (имя папки перекрывает теги) + наша 4-уровневая структура. Navidrome читает **только теги**,
> папки игнорирует полностью, бага не имеет. Сравнение движков —
> [[personal/tech/jellyfin-tags-cp1251-unreadable]].
>
> ✅ **Найденное решение: Navidrome** — читает теги, **папки игнорирует полностью**, бага не имеет.
> Детали и сравнение движков — [[personal/tech/jellyfin-tags-cp1251-unreadable]].
> Деплой-план — [[family/how-to/navidrome-truenas-android]].
> 🔴 **ИСТОЧНИК `Maria Makarova (organ)` НАЙДЕН (v7):** это **наш собственный тег**
> `artist=Maria Makarova (organ)` в файле `!Классика/Бах — Toccata and Fugue in D minor.mp3`.
> **НЕ MusicBrainz, НЕ «Маша Макарова» из Ногу Свело** — обе версии опровергнуты.
>
> ⏳ **ОТКРЫТЫЕ ЗАДАЧИ (см. §Открытые задачи в конце):**
> 1. Дополнение `Music/backup` — скан готов (1436 файлов не хватало), **ждёт решения Alex** по `.avi`/`.mpg`/`.DS_Store`;
> 2. Бэкап CSV на Mac — ✅ **выполнено**;
> 3. Аудит семантики `artist` — **не начат**;
> 4. Деплой Navidrome — **не начат**;
> 5. Lidarr — **не начат, отложен**.
>
> 📌 **Lidarr:** задача из исходной команды Alex остаётся в силе, но **отложена** —
> сначала библиотека в Navidrome. Новые закачки Lidarr тегирует **сам** через MusicBrainz
> (включая `Album Artist`), поэтому ручная правка нужна только для существующих 7861 файла.
## 🔀 v7: РЕШЕНИЕ — NAVIDROME ВМЕСТО JELLYFIN ДЛЯ МУЗЫКИ
**Проверено по официальной доке Navidrome и GitHub (2026-09-27).**
| | Jellyfin (баг #18162) | Navidrome |
|---|---|---|
| Источник имени артиста | **имя папки** перекрывает тег | **только тег** |
| Структура папок | обязательна `Artist/Album/Track` | **игнорируется** |
| Наша структура `категория/подпапка/файл` | ломает навигацию | **работает как есть** |
| Интернет-метаданные артистов | тянет из MusicBrainz | **не тянет** |
| Пишет в файлы | может | **никогда** (by design) |
| Видео | ✅ (видеотека остаётся здесь) | ❌ |
**Официальная дока Navidrome:**
> «Navidrome organizes your music library **entirely** based on the metadata tags in your audio
> files. Unlike some music players, **it does not use folder names or file names to group tracks**.»
### `ALBUMARTIST` в Navidrome — НЕ обязателен (ответ на вопрос Alex)
**Navidrome подставляет `artist`, если `albumartist` отсутствует** — цитата мейнтейнера
`deluan` (обсуждение #5924):
> «when an album artist tag is missing, Navidrome substitutes the **track artist** in its place»
**Что при этом происходит:**
| Ситуация | Результат |
|---|---|
| `ALBUMARTIST` у всех треков | 1 альбом ✅ |
| Нет `ALBUMARTIST`, 4 фита | **5 альбомов** вместо 1 ❌ |
| Нет `ALBUMARTIST`, сборник 18 треков | **до 18 альбомов** ❌ |
**Обход без правки тегов — конфиг `PID.Album`:**
```toml
PID.Album = "musicbrainz_albumid|albumartist,album,albumversion,releasedate"
```
> 🔑 Использовать **сырое `albumartist`**, НЕ `albumartistid` (последний никогда не пуст —
> вычисляется после подстановки track artist). `folder` в спеку класть нельзя как fallback.
> ⚠️ Смена `PID.Album` → полный рескан + новые ID → **бэкапить `navidrome.db`**.
### ✅ Новые закачки тегирует Lidarr сам
Lidarr матчит по **MusicBrainz release groups** и пишет полные теги, включая `Album Artist`
(штатное действие `Write Metadata Tags`). Существует официальная связка
[`navidrome-lidarr-bridge`](https://github.com/danielbanariba/navidrome-lidarr-bridge):
закачанное Lidarr'ом попадает в папку Navidrome и подхватывается автоматически.
## 📌 ОТКРЫТЫЕ ЗАДАЧИ (v7, для следующей сессии)
| # | Задача | Статус | Детали |
|---|---|---|---|
| 1 | Дополнить `Music/backup` | 🟡 **скан готов, ждёт решения** | не хватало **1436 файлов** (876 mp3, 287 jpg, 6 mpg, 5 avi, 18 `.DS_Store`). Вопрос Alex по видео/мусору — ответа нет |
| 2 | Бэкап CSV на Mac | ✅ **выполнено** | `/Users/admin/milestones/music-csv-2026-09-26/` — 3 CSV + MD5SUMS + README |
| 3 | Аудит семантики `artist` | 🔴 не начат | `artist=Классика в современной обработке`, `Maria Makarova (organ)` и т.п. — формально валидны, семантически мусор |
| 4 | Деплой Navidrome | 🔴 не начат | план — [[family/how-to/navidrome-truenas-android]] |
| 5 | Проставить `TPE2` | ⏸ отложено | нужно **только** если в Navidrome раздробятся сборники; для Jellyfin бессмысленно (баг) |
| 6 | Lidarr | 🔴 не начат | задача из исходной команды, отложена до библиотеки |
| 7 | Починить авто-бэкап Jellyfin | 🔴 не начат | `SQLiteBackups` пуста с 3 июня |
### 📦 Milestone: CSV сохранены на Mac (2026-09-27)
```
/Users/admin/milestones/music-csv-2026-09-26/
├── tag-inventory.csv 1.6 МБ md5 ca2d1767fd784771c44290529972a201
├── tag-inventory2.csv 1.7 МБ md5 52d90e676930110a76c979c0a2fa800c
├── tag-fix-plan.csv 2.2 МБ md5 8742abff7387e1ae719f3e35c6cf0176
├── MD5SUMS.txt
└── README.md
```
Копии read-only, оригиналы на NAS. **README содержит** описание колонок, распределение
`verdict`/`action`, и главную находку — **отсутствие `album_artist` в плане правок**.
## 🔴 v6: БАГ JELLYFIN #18162 — имя папки перекрывает теги