obsidian-vault/personal/plans/lampac-watchlist-plugin.md

created, namespace, related, status, tags, title, type, updated

created	namespace	related	status	tags	title	type	updated
2026-09-22	personal	personal/plans/lampac-kraken personal/tech/lampac-deployment family/projects/watchlist-sync family/projects/watchlist-automation family/documents/movies-watchlist	proposed	lampac lampa watchlist catalog webos plugin kraken	Watchlist в UI Lampa — каталог из списка	plan	2026-09-22

Watchlist в UI Lampa — каталог из списка (план)

Составлен 2026-09-22, переписан после разведки кода Catalog. Ждёт подтверждения Alex. Базовое развёртывание — personal/plans/lampac-kraken (шаги 1–6 закрыты).

Задача

Показывать список фильмов Alex (family/documents/movies-watchlist.md) в UI Lampa на ТВ — каталогом. Не локальный плейбэк. Формулировка Alex: «отображение фильмов из списка».

✅ Затык снят: чем это делается

В образе Lampac уже есть модуль Catalog — YAML-каталоги → плагин Lampa /catalog.js. Сейчас выключен. Писать плагин с нуля не нужно.

Как работает Catalog (разобрано по коду 2026-09-22)

Файлы в контейнере: /lampac/module/Catalog/ — Controllers/, plugin.js, README.md, sites/*.yaml (10 готовых примеров: vokino, rezka, kinopub, anime, …).

Механика

Что	Как
Данные	sites/<site>.yaml — описание сайта: host, menu, search, list, content
Подстановки	override/<site>.yaml и override/_.yaml — переопределения поверх базового
Роуты	/catalog.js (плагин), /catalog (JSON каналов), /catalog/list, /catalog/card
WAF	^/catalog/ → 10 запросов/сек
Имя файла	только [a-z0-9-]; есть fallback-поиск по displayname

Ключевое: обязателен HTTP

if (!url.StartsWith("http"))
    url = $"{init.host}/{url}";     // ListController.cs:87

host из YAML сканируется по HTTP (Http.Get / Playwright / RCH). Локальные файлы напрямую Catalog читать не умеет — только HTTP-ответ.

Два режима парсинга

bool? jsonPath = contentParse.jsonPath ?? init.jsonPath;

if (jsonPath == true)  json = JToken.Parse(html);   // JSON-режим
else                   doc.LoadHtml(html);          // HTML-режим

• jsonPath: true → ответ парсится как JSON, элементы берутся по nodes ($.channels[*].details)
• иначе → HTML через HtmlAgilityPack

🔴 Это и есть рычаг: любой свой HTTP-эндпоинт, отдающий JSON нужной формы, подойдёт как host. Тогда задача сводится к генерации JSON + YAML-обёртки, без правки кода Lampac.

Форма элемента (content в YAML)

content:
  nodes: "$.channels[*].details"     # jsonPath-выражение (JSON) или CSS/XPath (HTML)
  name:         { attribute: name }
  original_name:{ attribute: originalname }
  href:         { attribute: ident }
  image:        { attribute: poster }
  year:         { attribute: released }
  serial_key:   { attribute: type, format: |  return value is "serial" ? value : null; }
  args:
    - { name_arg: vote_average, attribute: rating_kp }

Карточка — отдельная секция card_parse + card_args (описание, рейтинги, жанры, страна). Полный живой пример — sites/vokino.yaml (копия в personal/tech/lampac-deployment, раздел Catalog).

Включение модуля — 2 правки

// current.conf (внутри контейнера /lampac/current.conf)
"SkipModules": [ "Tracks", "Transcoding", ... ]    // ← убрать "Catalog" (строка ~277)
"plugins": { ..., "catalog": true }                // ← было false (строка ~1653)

🔴 ПИТФОЛЛ — init.conf НЕ смонтирован. В нашем docker-compose.yml нет volume на /lampac/init.conf, файл живёт в образе. Правки через docker exec исчезнут при пересоздании контейнера (docker compose up, watchtower-обновление образа). Варианты:

• (а) добавить volume ./config/init.conf:/lampac/init.conf:ro — надёжно, но нужен первичный docker cp
• (б) править через AdminPanel /adminpanel (модуль, правит init.conf + current.conf)
• (в) docker cp + commit — плохо

Рекомендация: (а) — конфиг на HDD, переживает пересоздание.

Архитектура решения

family/documents/movies-watchlist.md          ← источник (vault, git-синхрон)
        │  существующий парсер: watchlist-sync/parser.py
        ▼
генератор (Python, на Кра́кене)
        │  пишет JSON нужной формы
        ▼
/lampac/... JSON-эндпоинт, доступный по HTTP с Lampac
        │
        ▼
sites/watchlist.yaml  ← Catalog-описание, host=<наш JSON URL>
   menu: Фильмы / Мультфильмы / Аниме  (по секциям .md)
        │
        ▼
Lampa на ТВ: плагин http://192.168.1.14:9118/catalog.js

Откуда отдавать JSON — варианты (выбрать на этапе реализации):

#	Где	Плюс	Минус
1	статика в /lampac/wwwroot/	ничего не поднимать, Lampac сам отдаёт	только чтение, обновление = перезапись файла
2	отдельный лёгкий HTTP-сервер на Кра́кене	есть API/логика	ещё один контейнер
3	file://	—	❌ не поддерживается (только http)

Склоняюсь к (1) — генерировать wwwroot/watchlist.json, Lampac отдаёт его сам, без новых сущностей.

Что показывать в каталоге

Секции берём из самого файла: ## Фильмы, ## Мультфильмы, ## Аниме → три категории меню. Поля: name (название), year, href (ссылка на Кинопоиск — уже есть в файле как [название](https://www.kinopoisk.ru/film/NNN/)), image — постер (можно взять через TMDB-кэш Lampac, tmdbproxy).

⚠️ href в файле — ссылка Кинопоиска, а Lampa ждёт карточку. Отрисовку карточки решает card_parse (в vokino он ходит по {host}/view/{uri}). Для нашего случая возможен режим только список, без карточки — проверить на этапе реализации.

Обновление каталога

• Генератор дёргать после watchlist-nightly.sh (уже кроном 01:00 на Кра́кене) — догенерировать JSON
• ⚠️ watchlist-nightly.sh в ~/scripts/ — root:root, правка только sudo install -m 755
• Партия данных меняется (⬇️, [x], 👍→перенос) — JSON пересобирать после каждого прогона

Шаги (черновик, уточняется на этапе реализации)

1. Включить модуль Catalog: SkipModules + catalog: true, закрепить init.conf volume.
2. Смонтировать module/Catalog/ (или только sites/ + override/) на HDD — чтобы каталоги не терялись.
3. Написать генератор movies-watchlist.md → JSON (переиспользовать parser.py из watchlist-sync).
4. Положить JSON туда, откуда Lampac отдаёт статику.
5. Написать sites/watchlist.yaml по образцу vokino.yaml.
6. Подключить на ТВ: Lampa → Настройки → Плагины → http://192.168.1.14:9118/catalog.js.
7. Приёмка: категории видны в UI Lampa на ТВ, названия совпадают со списком.

Откат

catalog: false + вернуть Catalog в SkipModules. Ничего в Lampac не патчится.

Правила отбора и сортировки (утверждено Alex 2026-09-22)

Фильтрация

Правило	Действие
[ ] непросмотренные	показывать
[x] просмотренные	❌ скрыть
👎	❌ скрыть
🗓️ upcoming	показывать (решить при реализации — есть в файле)
❓ ambiguous	показывать (название как есть)

Сортировка внутри списка — трёхключевая

1. ⭐ (U+2B50) — первыми
2. Рейтинг — по убыванию (IMDb/KP из строки файла; строки [название](kp) (год) IMDb N.N KP N.N)
3. Ужасы (🧟♀️, TMDB genre_id=27) — последними

⚠️ Только ⭐ (U+2B50) — как в sync-down (см. family/projects/watchlist-automation). ✭ (U+272D) приоритетом не является.

Порядок секций

1. Главный список — первым. Это ## Фильмы
2. Дальше — остальные по порядку в файле: ## Новинки - 👍/👎, ## Мультфильмы, ## Аниме, …

⚠️ ## Новинки👎 — не показывать (это скрытая секция отказов). ⚠️ Секция ## Новинки содержит 👍/👎; 👎-строки прячем, 👍 показываем.

Источник рейтинга

В строках со ссылками Кинопоиска рейтинг уже в тексте: IMDb 7.6 KP 8.2. Для строк без рейтинга (например - [ ] Gods don't give gifts) — сортировать как 0, в конец группы. Опционально: добирать через TMDB (кэш tmdbproxy в Lampac) — решить при реализации.

Открытые вопросы

1. Нужна ли карточка (описание/рейтинг внутри Lampa), или достаточно списка названий с постерами?
2. Постеры — тянуть через TMDB-кэш Lampac или не тянуть вовсе?
3. 🗓️ upcoming — показывать или прятать? (сейчас по умолчанию показываем)

Связанные

• personal/plans/lampac-kraken — базовое развёртывание
• personal/tech/lampac-deployment — эксплуатация, порты, питфоллы
• family/projects/watchlist-sync — парсер списка, CLI
• family/projects/watchlist-automation — форматы маркеров, cron
• family/documents/movies-watchlist — источник данных