Каталог сериалов и сезонов
Находит сезоны и эпизоды по шаблонам SxxEyy и 1x01, считая серии и пропуски.
Что делает скрипт
Скрипт разбирает дерево сериала, определяет название шоу, сезон и номер эпизода, затем сводит статистику. Отчёт можно сохранить в CSV для сверки с диском. Файлы не переименовываются, отсутствующие серии только помечаются.
Быстрый старт
python series_catalog.py --dir ~/TV --csv series.csv
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python series_catalog.py --dir ~/TVpython series_catalog.py --dir ~/TV --csv series.csvpython series_catalog.py --dir D:\TV --json series.json
Что понадобится
winget install Python.Python.3.12
brew install python
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.