#!/usr/bin/env python3 """Проверяет таймкоды субтитров относительно длительности видео.""" from __future__ import annotations import argparse import json import shutil import subprocess from pathlib import Path import pysubs2 def probe_duration(path: Path) -> float | None: if shutil.which("ffprobe") is None: raise SystemExit("ffprobe не найден. Установите FFmpeg.") result = subprocess.run( [ "ffprobe", "-v", "error", "-show_entries", "format=duration", "-of", "default=noprint_wrappers=1:nokey=1", str(path), ], capture_output=True, text=True, check=False, ) if result.returncode: return None try: return float(result.stdout.strip()) except ValueError: return None def main() -> int: parser = argparse.ArgumentParser(description="Проверить синхронизацию субтитров") parser.add_argument("--subtitle", type=Path, required=True, help="Файл субтитров") parser.add_argument("--video", type=Path, help="Видео для сравнения") parser.add_argument("--tolerance", type=float, default=2.0, help="Допуск в секундах") parser.add_argument("--json", type=Path, help="Сохранить отчёт в JSON") parser.add_argument("--strict", action="store_true", help="Вернуть код 1 при найденных проблемах") args = parser.parse_args() subtitle = args.subtitle.expanduser().resolve() if not subtitle.is_file(): parser.error(f"Файл субтитров не найден: {subtitle}") try: subs = pysubs2.load(str(subtitle)) except Exception as error: parser.error(f"Не удалось прочитать субтитры: {error}") events = [event for event in subs if event.text.strip()] if not events: print("Реплики не найдены.") return 1 first_ms = min(event.start for event in events) last_ms = max(event.end for event in events) issues: list[str] = [] duration = None if first_ms < 0: issues.append("Первая реплика начинается до нуля.") if first_ms > 60_000: issues.append(f"Первая реплика появляется поздно: {first_ms / 1000:.1f} s.") if any(event.end <= event.start for event in events): issues.append("Есть события с нулевой или отрицательной длительностью.") if args.video: video = args.video.expanduser().resolve() if not video.is_file(): parser.error(f"Видео не найдено: {video}") duration = probe_duration(video) if duration is None: issues.append("ffprobe не смог определить длительность видео.") else: if last_ms / 1000 > duration + args.tolerance: issues.append( f"Субтитры выходят за видео на {last_ms / 1000 - duration:.1f} s." ) if last_ms / 1000 < duration - 60: issues.append( f"Субтитры заканчиваются раньше видео на {duration - last_ms / 1000:.1f} s." ) report = { "subtitle": str(subtitle), "events": len(events), "first_seconds": round(first_ms / 1000, 3), "last_seconds": round(last_ms / 1000, 3), "video_seconds": round(duration, 3) if duration is not None else None, "issues": issues, } print(f"Событий: {len(events)}") print(f"Первый таймкод: {first_ms / 1000:.3f} s") print(f"Последний таймкод: {last_ms / 1000:.3f} s") if duration is not None: print(f"Длительность видео: {duration:.3f} s") if issues: print("Замечания:") for issue in issues: print(f" - {issue}") else: print("Явных расхождений не найдено.") 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}") if issues and args.strict: return 1 return 0 if __name__ == "__main__": raise SystemExit(main())