Медиатека

Каталог сериалов и сезонов

Находит сезоны и эпизоды по шаблонам SxxEyy и 1x01, считая серии и пропуски.

Python Windows macOS Linux Средний
Скачать series_catalog.py
Описание

Что делает скрипт

Скрипт разбирает дерево сериала, определяет название шоу, сезон и номер эпизода, затем сводит статистику. Отчёт можно сохранить в CSV для сверки с диском. Файлы не переименовываются, отсутствующие серии только помечаются.

Запуск

Быстрый старт

python series_catalog.py --dir ~/TV --csv series.csv

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python series_catalog.py --dir ~/TV
  • python series_catalog.py --dir ~/TV --csv series.csv
  • python series_catalog.py --dir D:\TV --json series.json
Зависимости

Что понадобится

Python 3.10+ Интерпретатор и стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Исходник

series_catalog.py

#!/usr/bin/env python3
"""Собирает каталог сериалов, сезонов и эпизодов."""
from __future__ import annotations

import argparse
import csv
import json
import re
from collections import defaultdict
from pathlib import Path

VIDEO_EXTENSIONS = {".mkv", ".mp4", ".avi", ".mov", ".m4v", ".wmv"}
EPISODE = re.compile(
    r"(?i)(?:s(?P<season>\d{1,2})[ ._-]*e(?P<episode>\d{1,3})|"
    r"(?P<season2>\d{1,2})x(?P<episode2>\d{1,3}))"
)


def series_name(path: Path, root: Path) -> str:
    relative = path.relative_to(root)
    if len(relative.parts) > 1:
        return relative.parts[0]
    return path.parent.name


def main() -> int:
    parser = argparse.ArgumentParser(description="Каталог сериалов")
    parser.add_argument("--dir", type=Path, required=True, help="Корень библиотеки сериалов")
    parser.add_argument("--csv", type=Path, help="Сохранить CSV")
    parser.add_argument("--json", type=Path, help="Сохранить JSON")
    args = parser.parse_args()

    root = args.dir.expanduser().resolve()
    if not root.is_dir():
        parser.error(f"Папка не найдена: {root}")

    data: dict[str, dict[int, set[int]]] = defaultdict(lambda: defaultdict(set))
    files = 0
    unmatched = 0
    for path in sorted(root.rglob("*")):
        if not path.is_file() or path.suffix.lower() not in VIDEO_EXTENSIONS:
            continue
        files += 1
        match = EPISODE.search(path.name)
        if not match:
            unmatched += 1
            continue
        season = int(match.group("season") or match.group("season2"))
        episode = int(match.group("episode") or match.group("episode2"))
        data[series_name(path, root)][season].add(episode)

    if not data:
        print("Сериалы не найдены.")
        return 1

    rows = []
    for series in sorted(data):
        for season in sorted(data[series]):
            episodes = sorted(data[series][season])
            expected = set(range(episodes[0], episodes[-1] + 1))
            missing = sorted(expected - set(episodes))
            rows.append(
                {
                    "series": series,
                    "season": season,
                    "episodes": len(episodes),
                    "first": episodes[0],
                    "last": episodes[-1],
                    "missing": ",".join(str(item) for item in missing),
                }
            )
            note = f", пропуски: {missing}" if missing else ""
            print(f"{series} S{season:02d}: {len(episodes)} серий{note}")

    if args.csv:
        target = args.csv.expanduser()
        target.parent.mkdir(parents=True, exist_ok=True)
        with target.open("w", encoding="utf-8", newline="") as handle:
            writer = csv.DictWriter(
                handle,
                fieldnames=["series", "season", "episodes", "first", "last", "missing"],
            )
            writer.writeheader()
            writer.writerows(rows)
        print(f"CSV: {target}")
    if args.json:
        target = args.json.expanduser()
        target.parent.mkdir(parents=True, exist_ok=True)
        target.write_text(json.dumps(rows, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
        print(f"JSON: {target}")

    print(f"Файлов: {files}, без номера серии: {unmatched}")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get media-series-catalog
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Медиатека

Плейлисты, метаданные, обложки, субтитры и порядок в коллекциях.