Видео

Добавить субтитры в видео

Встраивает внешний SRT или ASS в MP4, MKV или WebM без перекодирования картинки.

Python Windows macOS Linux Средний
Скачать add_subtitles.py
Описание

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

Скрипт выбирает кодек субтитров по контейнеру: mov_text для MP4, SRT для MKV и WebVTT для WebM. Видео и звук копируются как есть, добавляется только новая дорожка с языковой меткой. По умолчанию результат сохраняется в отдельный MKV-файл.

Запуск

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

python add_subtitles.py movie.mp4 subtitles.srt

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

Примеры

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

  • python add_subtitles.py movie.mp4 subtitles.srt
  • python add_subtitles.py film.mkv russian.ass --language rus --title Russian
  • python add_subtitles.py clip.mp4 subs.srt --output clip_subs.mkv
Зависимости

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

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
FFmpeg 6+ ffmpeg и ffprobe
Windows winget install Gyan.FFmpeg
macOS brew install ffmpeg
Linux sudo apt install ffmpeg
Исходник

add_subtitles.py

#!/usr/bin/env python3
"""Встраивание внешних субтитров в видео."""
from __future__ import annotations

import argparse
import shutil
import subprocess
from pathlib import Path

CODECS = {
    ".mp4": "mov_text",
    ".m4v": "mov_text",
    ".mov": "mov_text",
    ".mkv": "srt",
    ".webm": "webvtt",
}


def main() -> int:
    parser = argparse.ArgumentParser(description="Добавить субтитры в видео")
    parser.add_argument("video", type=Path)
    parser.add_argument("subtitles", type=Path)
    parser.add_argument("--output", "-o", type=Path)
    parser.add_argument("--language", default="rus", help="Код языка, например rus или eng")
    parser.add_argument("--title", default="", help="Название дорожки")
    parser.add_argument("--overwrite", action="store_true")
    args = parser.parse_args()

    if shutil.which("ffmpeg") is None:
        raise SystemExit("Не найден ffmpeg. Установите FFmpeg.")
    video = args.video.expanduser()
    subtitles = args.subtitles.expanduser()
    if not video.is_file():
        parser.error(f"Видео не найдено: {video}")
    if not subtitles.is_file():
        parser.error(f"Субтитры не найдены: {subtitles}")

    target = args.output.expanduser() if args.output else Path("subtitled") / f"{video.stem}_subs.mkv"
    suffix = target.suffix.lower()
    if suffix not in CODECS:
        parser.error("Поддерживаются контейнеры MP4, MOV, MKV и WebM")
    if target.resolve() in {video.resolve(), subtitles.resolve()}:
        raise SystemExit("Результат не должен совпадать с исходным файлом")
    if target.exists() and not args.overwrite:
        raise SystemExit(f"Файл уже существует: {target}. Добавьте --overwrite.")
    target.parent.mkdir(parents=True, exist_ok=True)

    command = [
        "ffmpeg", "-hide_banner", "-nostdin",
        "-i", str(video), "-i", str(subtitles),
        "-map", "0:v:0", "-map", "0:a?", "-map", "1:0",
        "-c:v", "copy", "-c:a", "copy", "-c:s", CODECS[suffix],
        "-metadata:s:s:0", f"language={args.language}",
    ]
    if args.title:
        command += ["-metadata:s:s:0", f"title={args.title}"]
    command += ["-y" if args.overwrite else "-n", str(target)]

    print(f"Контейнер: {suffix}, кодек субтитров: {CODECS[suffix]}")
    result = subprocess.run(command, check=False)
    if result.returncode != 0:
        raise SystemExit(f"ffmpeg завершился с кодом {result.returncode}")
    print(f"Готово: {target}")
    return 0


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

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

CLI 1.0.0

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

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

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

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

Категория

Видео

Монтаж, сжатие, субтитры, кадры и пакетная обработка видео.