Медиатека

Проверить синхронизацию субтитров

Сравнивает последнюю реплику с длительностью видео через ffprobe и отмечает явные расхождения.

Python Windows macOS Linux Продвинутый
Скачать subtitle_sync_check.py
Описание

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

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

Запуск

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

python subtitle_sync_check.py --subtitle movie.srt --video movie.mkv

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

Примеры

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

  • python subtitle_sync_check.py --subtitle movie.srt
  • python subtitle_sync_check.py --subtitle movie.srt --video movie.mkv
  • python subtitle_sync_check.py --subtitle movie.srt --video movie.mkv --json check.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
FFmpeg Утилиты ffmpeg и ffprobe
Windows winget install Gyan.FFmpeg
macOS brew install ffmpeg
Linux 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())

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

CLI 1.0.0

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

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

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

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

Категория

Медиатека

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