Добавить субтитры в видео
Встраивает внешний SRT или ASS в MP4, MKV или WebM без перекодирования картинки.
Что делает скрипт
Скрипт выбирает кодек субтитров по контейнеру: 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.srtpython add_subtitles.py film.mkv russian.ass --language rus --title Russianpython add_subtitles.py clip.mp4 subs.srt --output clip_subs.mkv
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
winget install Gyan.FFmpeg
brew install ffmpeg
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.