Медиатека

Найти битые субтитры

Проверяет SRT, VTT и ASS на пустые реплики, отрицательные времена, наложения и дубликаты.

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

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

Скрипт рекурсивно загружает файлы через pysubs2 и выполняет набор проверок целостности. Для каждой проблемы выводится файл, номер события и причина. Это только диагностика, файлы не редактируются.

Запуск

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

python broken_subtitles.py --path ./subtitles

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

Примеры

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

  • python broken_subtitles.py --path ./subtitles
  • python broken_subtitles.py --path movie.srt
  • python broken_subtitles.py --path D:\Media --json broken.json
Зависимости

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

Python 3.10+ Интерпретатор и стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
pysubs2 Разбор и запись файлов субтитров
Windows py -m pip install pysubs2
macOS python3 -m pip install pysubs2
Linux python3 -m pip install pysubs2
Исходник

broken_subtitles.py

#!/usr/bin/env python3
"""Ищет типичные проблемы в файлах субтитров."""
from __future__ import annotations

import argparse
import json
from pathlib import Path

import pysubs2

EXTENSIONS = {".srt", ".vtt", ".ass", ".ssa"}


def check_file(path: Path) -> list[dict]:
    issues = []
    try:
        subs = pysubs2.load(str(path))
    except Exception as error:
        return [{"event": 0, "kind": "parse", "detail": str(error)}]

    seen = set()
    previous = None
    for index, event in enumerate(subs, start=1):
        text = event.text.strip()
        if not text:
            issues.append({"event": index, "kind": "empty", "detail": "Пустой текст"})
        if event.start < 0 or event.end < 0:
            issues.append({"event": index, "kind": "negative", "detail": "Отрицательный таймкод"})
        if event.end <= event.start:
            issues.append({"event": index, "kind": "duration", "detail": "Конец не позже начала"})
        if event.end - event.start > 120_000:
            issues.append({"event": index, "kind": "long", "detail": "Реплика длиннее 120 секунд"})
        if previous is not None and event.start < previous.end - 500:
            issues.append({"event": index, "kind": "overlap", "detail": "Наложение с предыдущей репликой"})
        key = (event.start, event.end, text)
        if key in seen:
            issues.append({"event": index, "kind": "duplicate", "detail": "Полный дубликат реплики"})
        seen.add(key)
        previous = event
    return issues


def main() -> int:
    parser = argparse.ArgumentParser(description="Найти битые субтитры")
    parser.add_argument("--path", type=Path, required=True, help="Файл или папка")
    parser.add_argument("--json", type=Path, help="Сохранить отчёт в JSON")
    args = parser.parse_args()

    source = args.path.expanduser().resolve()
    if not source.exists():
        parser.error(f"Путь не найден: {source}")
    if source.is_file():
        files = [source] if source.suffix.lower() in EXTENSIONS else []
    else:
        files = sorted(path for path in source.rglob("*") if path.is_file() and path.suffix.lower() in EXTENSIONS)

    if not files:
        print("Файлы субтитров не найдены.")
        return 1

    report = []
    total_issues = 0
    for path in files:
        issues = check_file(path)
        if not issues:
            continue
        total_issues += len(issues)
        print(f"{path}: {len(issues)} проблем")
        for issue in issues[:20]:
            print(f"  event {issue['event']}: {issue['kind']} - {issue['detail']}")
        if len(issues) > 20:
            print(f"  и ещё {len(issues) - 20}")
        report.append({"file": str(path), "issues": issues})

    print(f"Проверено файлов: {len(files)}, проблем: {total_issues}")
    if args.json:
        target = args.json.expanduser()
        target.parent.mkdir(parents=True, exist_ok=True)
        target.write_text(json.dumps(report, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
        print(f"Отчёт: {target}")
    return 0


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

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

CLI 1.0.0

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

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

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

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

Категория

Медиатека

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