Медиатека

Объединить два файла субтитров

Склеивает две дорожки в один SRT с настраиваемым сдвигом второй части.

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

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

Скрипт загружает оба файла, при необходимости смещает вторую дорожку и сортирует события по времени. Дубликаты с одинаковыми таймкодами сохраняются, чтобы не потерять перевод. Результат пишется в новый файл, перезапись защищена --force.

Запуск

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

python subtitle_merge.py --first ru.srt --second en.srt --output both.srt

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

Примеры

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

  • python subtitle_merge.py --first ru.srt --second en.srt --output both.srt
  • python subtitle_merge.py --first part1.srt --second part2.srt --offset 5.0 --output full.srt
  • python subtitle_merge.py --first a.ass --second b.srt --output merged.srt --force
Зависимости

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

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
Исходник

subtitle_merge.py

#!/usr/bin/env python3
"""Объединяет два файла субтитров в один SRT."""
from __future__ import annotations

import argparse
from pathlib import Path

import pysubs2


def load(path: Path) -> pysubs2.SSAFile:
    try:
        return pysubs2.load(str(path))
    except Exception as error:
        raise SystemExit(f"Не удалось прочитать {path}: {error}")


def main() -> int:
    parser = argparse.ArgumentParser(description="Объединить субтитры")
    parser.add_argument("--first", type=Path, required=True, help="Первый файл")
    parser.add_argument("--second", type=Path, required=True, help="Второй файл")
    parser.add_argument("--offset", type=float, default=0.0, help="Сдвиг второго файла в секундах")
    parser.add_argument("--output", type=Path, required=True, help="Итоговый SRT")
    parser.add_argument("--force", action="store_true", help="Перезаписать итоговый файл")
    args = parser.parse_args()

    first_path = args.first.expanduser().resolve()
    second_path = args.second.expanduser().resolve()
    for path in (first_path, second_path):
        if not path.is_file():
            parser.error(f"Файл не найден: {path}")

    output = args.output.expanduser().resolve()
    if output.exists() and not args.force:
        parser.error(f"Файл уже существует: {output}. Добавьте --force.")

    first = load(first_path)
    second = load(second_path)
    second.shift(s=args.offset)

    merged = pysubs2.SSAFile()
    for event in list(first) + list(second):
        if event.text.strip():
            merged.events.append(event.copy())
    merged.events.sort(key=lambda event: (event.start, event.end))

    output.parent.mkdir(parents=True, exist_ok=True)
    merged.save(str(output), format_="srt")
    print(f"Сохранено событий: {len(merged)}")
    print(f"Результат: {output}")
    return 0


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

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

CLI 1.0.0

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

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

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

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

Категория

Медиатека

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