Автор

До змісту документації · Шаблони каталогів · Схема каталогу

Для серіалів використовуються ті самі параметри джерела й пакетів, що й для фільмів. Кожен відповідний каталог верхнього рівня займає одне місце в пакеті, включно з усіма вкладеними сезонами. Для виявлення відео повинно бути більшим за 100 MiB.

Вигляд джерела Тлумачення
11.22.63/11.22.63-01.mkv — -08.mkv Послідовно пронумеровані епізоди; LLM визначає серіал і пропонує відсутній номер сезону.
12-Monkeys/12-Monkeys-S01E01.mkv Явний сезон і епізод, навіть для одного відео.
Slow-Horses/season-2/...S02E05... та інші папки сезонів Один вибраний серіал із зіставленням окремих епізодів усіх сезонів.
Show 1x01, Show S01 E01, Show-S01-E01, Show Season 1 Episode 01 Альтернативні форми явних номерів сезону й епізоду.
Show/season-1/show.103.hdtv.mp4 Стислі номери беруть контекст сезону з назви папки. Номер епізоду в безпосередній папці випуску теж може ідентифікувати відео.
Black Lagoon 01 The Black Lagoon.mkv Нумеровані епізоди з назвами й однаковим префіксом серіалу.

Шаблони серіалів мають перевагу над фільмами з двох частин. LLM не може змінити явно зазначені номери сезону та епізоду. Пронумеровані файли повинні мати спільний префікс і унікальні відповідності епізодів. Сезон 0 дозволений для спеціальних випусків. Підтримуються назви епізодів, що починаються з чисел, як-от S01E01 1200 A.M. або Season 2 Episode 09 - 4 Days Out.

Виявлення вибирає розпізнавані епізоди, навіть якщо інші відеофайли в папці не можна зіставити. Додаткові матеріали, фільми про створення, відео з кількома епізодами, повторні відповідності та файли із сезоном, що суперечить папці, залишаються у джерелі. Їхні субтитри не перепризначаються вибраним епізодам. Пропущені відео видно в Match Results, а подія сканування фіксує вибрану та пропущену кількість. Очищення зберігає будь-які медіафайли чи субтитри, що залишилися.

Префікси назв не дозволяють включати очевидно неправильно розкладені серіали до батьківського. Колекції кількох різних серіалів без спільного заголовка залишаються невизначеними; кожен серіал слід розмістити окремим безпосереднім дочірнім каталогом джерела. Фільмові продовження з цифрами без нулів на початку у змішаній папці не вважаються серіалами. Виявлення очікує один епізод на відео та не переписує конфліктні номери. Щоб застосувати нові правила до вже просканованих каталогів, почніть новий пакет.

Ідентифікація серіалу має два етапи. Спершу LLM отримує find -ls та викликає submit_tv_series, передаючи тільки назву серіалу й упевненість. TMDB шукає за назвою без фільтра року. Кілька збігів передаються на звичайний вибір LLM, нуль збігів спричиняє повторну ідентифікацію без пошуку сусідніх років. Ручне виправлення TMDB ID також розв’язує назву до зіставлення епізодів. Рік на екрані походить із вибраного запису TMDB, не з припущення LLM.

Далі новий діалог отримує підтверджені назву й рік, контекст папки й відсортовані відносні імена файлів під числовими ключами 1, 2 тощо у JSON. Повні серверні шляхи та сирий find -ls не входять до цього запиту. Модель повертає лише числові відповідності ID файлу / сезон / епізод і не може змінити серіал. Сервер призначає ID та зіставляє їх із точними початковими шляхами; LLM не мусить повторювати імена. Кожен ID має з’явитися рівно один раз. Відповідності й маркер завершення зберігаються разом. Невирішені відповідності залишають файли на місці. Кожен епізод перевіряється за сезоном і епізодом TMDB перед імпортом; невідомі залишаються в джерелі, а решта правильних можуть завершитися.

Event Log і Current Task розділяють ідентифікацію серіалу, вибір кандидата, зіставлення епізодів та імпорт. Пакет звітує Series identified, Episodes mapped, Imported на відповідних етапах.

Призначення та іменування

Пакет зберігає окреме призначення для серіалів поруч із каталогом фільмів — папку tv на тому самому рівні. Для стандартного призначення фільмів серіали автоматично потрапляють до /exports/disk1/archive/media/tv.

Наприклад:

tv/
  Slow Horses (2022)/
    Season 02/
      Slow Horses (2022) S02E05 - Boardroom Politics.mkv
      Slow Horses (2022) S02E05 - Boardroom Politics.srt

Назва й рік серіалу та назва епізоду беруться з TMDB. Якщо нормалізація повністю прибирає назву епізоду (наприклад, /), ім’я файлу закінчується номером сезону й епізоду, а каталог зберігає початкову назву. Зіставлення SRT виконується детермінованими правилами; неоднозначні SRT залишаються невирішеними. Файли переміщуються через жорсткі посилання та видалення початкових імен без копіювання або перечитування відео. Наявні файли призначення вимагають явного Replace Local Media.

Контрольні точки й каталог

Каталог серіалів має таблиці серіалів, сезонів, епізодів, їхніх файлів, титрів серіалів і епізодів, зображень та власних жанрів. Таблиці людей і типів ролей спільні з фільмами. Простори ID для фільмів і серіалів окремі, зокрема й URL каталогу.

Записи кожного епізоду й контрольна точка робочої області фіксуються разом до видалення джерела. Після перезапуску можна завершити зафіксоване переміщення без повторного імпорту готових епізодів. Помилка одного епізоду не відкочує інші. Очищення рекурсивне: будь-який підтримуваний медіафайл чи SRT на будь-якій глибині або символьне посилання на папку зберігає дерево джерела.

Пошук і останні додавання в каталозі включають серіали. Сторінки серіалів показують імпортовані епізоди з описами, датами виходу, тривалістю, кадрами, розгортаними титрами та локальними файлами. Match Results показує зіставлення епізодів і результат імпорту кожного відео.

Встановлення й оновлення застосовують схему серіалів та розгортають нові модулі й запити до моделі. Функція не виправляє і не перекласифіковує вже завершені пакети фільмів.