Найти битые субтитры
Проверяет SRT, VTT и ASS на пустые реплики, отрицательные времена, наложения и дубликаты.
Что делает скрипт
Скрипт рекурсивно загружает файлы через pysubs2 и выполняет набор проверок целостности. Для каждой проблемы выводится файл, номер события и причина. Это только диагностика, файлы не редактируются.
Быстрый старт
python broken_subtitles.py --path ./subtitles
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python broken_subtitles.py --path ./subtitlespython broken_subtitles.py --path movie.srtpython broken_subtitles.py --path D:\Media --json broken.json
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
py -m pip install pysubs2
python3 -m pip install pysubs2
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.