Проверить синхронизацию субтитров
Сравнивает последнюю реплику с длительностью видео через ffprobe и отмечает явные расхождения.
Что делает скрипт
Скрипт читает субтитры, измеряет первый и последний таймкод и при указании видео получает его длительность. Отчёт показывает, выходят ли реплики за пределы фильма и насколько рано заканчиваются. Ничего не исправляется автоматически, меняется только вывод.
Быстрый старт
python subtitle_sync_check.py --subtitle movie.srt --video movie.mkv
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python subtitle_sync_check.py --subtitle movie.srtpython subtitle_sync_check.py --subtitle movie.srt --video movie.mkvpython subtitle_sync_check.py --subtitle movie.srt --video movie.mkv --json check.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
winget install Gyan.FFmpeg
brew install ffmpeg
sudo apt install ffmpeg
subtitle_sync_check.py
#!/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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.