From 6d8cd5e1eb1fd0f338fb402ac3d3be811bacb3d3 Mon Sep 17 00:00:00 2001
From: Alexey Martemyanov <mallexxx@gmail.com>
Date: Thu, 24 Sep 2026 16:47:45 +0600
Subject: [PATCH] [2026-09-24] eagle: personal/tech/lampa-jellyfin-plugin.md

---
 personal/tech/lampa-jellyfin-plugin.md | 103 +++++++++++++++++++++++++
 1 file changed, 103 insertions(+)
 create mode 100644 personal/tech/lampa-jellyfin-plugin.md

diff --git a/personal/tech/lampa-jellyfin-plugin.md b/personal/tech/lampa-jellyfin-plugin.md
new file mode 100644
index 00000000..0c64bcbe
--- /dev/null
+++ b/personal/tech/lampa-jellyfin-plugin.md
@@ -0,0 +1,103 @@
+---
+created: '2026-09-24'
+namespace: personal
+related:
+  - '[[personal/plans/lampac-kraken]]'
+  - '[[family/how-to/jellyfin-config]]'
+  - '[[personal/plans/kraken-media-inventory-cleanup]]'
+  - '[[family/how-to/tv-lampac-plugin]]'
+status: research-done-install-not-started
+tags:
+  - lampa
+  - lampac
+  - jellyfin
+  - plugin
+  - kraken
+  - documentaries
+  - cartoons
+title: lampa-jellyfin-plugin — документалки Jellyfin в Lampa
+type: tech-note
+updated: '2026-09-24'
+---
+# Документалки Jellyfin в Lampa — исследование (2026-09-24)
+
+> Вопрос Alex: BBC-документалки, закачанные в Jellyfin на Kraken, — реально ли найти
+> в Lampa? Есть ли плагин для документалок (и мультфильмов)?
+
+## Ответ одним абзацем
+
+Да — есть готовый **Jellyfin-плагин для Lampa** (официальный стор lampaplugins).
+Показывает библиотеку Jellyfin прямо в Lampa. Отдельного «плагина документалок»
+не существует и не нужен: жанры «Документальные»/«Мультфильмы» встроены в CUB.
+
+## Ключевые факты
+
+### 1. Lampa не играет с диска Kraken
+
+TorrServer встроенный, `UseDisk: false` — Lampa стримит с торрентов/онлайн.
+Файлы `media/` (включая 307,5 ГБ документалок) участвуют только в Jellyfin.
+См. [[personal/plans/kraken-media-inventory-cleanup]].
+
+### 2. Документалки в «Мой список» отсутствуют
+
+Категории каталога: Фильмы 360 · Новинки 34 · Мультфильмы 3 · Аниме 7.
+Из 45 документальных позиций на диске — **0 в списке**.
+Диск: `documentaries` 72 ГБ (25 поз.) + `documentaries-series` 236 ГБ (20 поз.),
+копий на TrueNAS нет. 9 раздач в Transmission ещё сидировались (на 2026-09-22).
+
+### 3. Jellyfin-плагин для Lampa — существует
+
+Официальный стор: `https://lampaplugins.github.io/store/` (подключается сам
+как плагин store.js). Проверено 2026-09-24, страницы отдают контент.
+
+| Плагин | URL | Что даёт |
+|---|---|---|
+| Jellyfin (@pavelpikta, v1.4.0) | `https://lampaplugins.github.io/store/pavelpikta/jellyfin.js` | Фильмы/сериалы/«продолжить»/новинки, TMDB-постеры, дедуп по TMDB ID, отметки просмотренного, выбор пользователя, эпизод-пикер |
+| Jellyfin Extended | `https://lampaplugins.github.io/store/wmajiug3e/jellyfin.js` | То же + сезоны/эпизоды, HLS-транскод с выбором качества, синк прогресса |
+
+Настройка: `jellyfinUrl` (для нас `http://192.168.1.14:8096`) + `jellyfinKey` —
+**API-ключ** (Jellyfin: Dashboard → API Keys).
+🔴 **На Kraken API-ключа НЕТ** — создать при установке.
+
+**webOS → external player → direct stream** (`Static=true`): транскод
+не используется, RPi5 не грузится. HLS-транскод (пресеты 360p–2160p) включается
+только для внутреннего плеера Lampa, не для webOS.
+
+### 4. Плагины «документалки/мультфильмы»
+
+Проверены каталоги lampa.nnslvp.io/plugins (115 плагинов) и lampaplugins store —
+отдельного плагина под документалки нет. Варианты:
+
+- **CUB встроено:** Каталог → Жанры → «Документальные» (TMDB 99) и
+  «Мультфильмы» (16) — без плагинов.
+- «Подборки» (`https://lampaplugins.github.io/store/p.js`) — коллекции
+  онлайн-кинотеатров, мультсериалы и мультфильмы.
+- В «Мой список» уже есть категория «Мультфильмы» (3 позиции).
+- Свой вариант: категория «Документалки» в «Мой список» через отработанный
+  пайплайн (Catalog + генератор) — если нужен список своих позиций,
+  а не вся библиотека Jellyfin.
+
+## ⚠️ Перед подключением плагина
+
+1. **Rescan Jellyfin не сделан** (шаг 6h плана cleanup, 2026-09-22): в библиотеке
+   фантомы удалённых фильмов. Dashboard → Libraries → Scan All Libraries (~10 с).
+2. Приёмка = раздел Jellyfin в UI Lampa на ТВ + запуск эпизода доксерила.
+
+## План установки (ждёт команды Alex)
+
+1. Создать API-ключ в Jellyfin (Dashboard → API Keys) + сделать rescan.
+2. Добавить плагин на ТВ: Lampa → Настройки → Плагины/Расширения →
+   «Добавить плагин» → URL. (SSH-вариант — [[family/how-to/tv-lampac-plugin]],
+   но пультом проще.)
+3. В настройках плагина: сервер `http://192.168.1.14:8096`, ключ, выбрать пользователя.
+4. Полный перезапуск Lampa (каталоги/плагины регистрируются только на старте).
+5. Приёмка в UI: раздел Jellyfin, постеры, запуск эпизода.
+
+Объём: ~15 минут.
+
+## Связанные
+
+- [[personal/plans/lampac-kraken]] — базовое развёртывание Lampac
+- [[family/how-to/jellyfin-config]] — Jellyfin на Kraken
+- [[family/how-to/tv-lampac-plugin]] — как добавляются плагины на ТВ
+- [[personal/plans/kraken-media-inventory-cleanup]] — что осталось на диске