library_sync.py собирает фильмы и сериалы (Jellyfin), документы (Paperless), книги (Calibre), альбомы (Navidrome), фотоальбомы (Immich) и заводит на них карточки в ядре. Запуск 04:15. Проверено самопроверкой без сервисов: создаются 2 карточки, поиск их находит, после проверки удалены. Реальный прогон: пять источников без ошибок, карточек 0 (библиотеки пусты). Ловушки: albumName в Immich требует кавычек (SQL через файл), русский поисковый запрос требует urlencode.
2.1 KiB
2.1 KiB
Единый каталог
Содержимое всех библиотек становится карточками ядра — после этого поиск и история работают одинаково для любого сервиса.
Что синхронизируется
| Сервис | Вид карточки | Ключ |
|---|---|---|
| Jellyfin | фильм, сериал | jellyfin:<id> |
| Paperless | документ | paperless:<id> |
| Calibre | книга | calibre:<id> |
| Navidrome | музыка (альбом) | navidrome:<id> |
| Immich | фотоальбом | immich:<id> |
Запуск: 04:15 ежедневно (/etc/cron.d/hub-catalog),
лог /var/log/hub-catalog.log.
Почему это важно
Раньше в ядре были только события: «что-то скачалось». Теперь в ядре лежит сам контент: можно найти книгу, фильм или документ, увидеть его историю и связать с другими карточками.
Проверено
Самопроверка (--selftest) без обращения к сервисам:
jellyfin: 1 карточек, calibre: 1 карточек
создано: 2, ошибок: 0
поиск видит: 2
То есть карточки создаются и находятся поиском. После проверки тестовые карточки удалены.
Реальный прогон: все пять источников отвечают без ошибок, карточек 0 — библиотеки пусты. Это ожидаемо и отличается от «сломалось».
Ловушки
- В Immich колонка называется
albumName— требует кавычек, поэтому SQL передаётся файлом, а не строкой в аргументах (иначе кавычки съедаются). - Поиск по-русски в URL нужно кодировать (
urllib.parse.urlencode), иначе ядро не находит.