Видео

Извлечь субтитры из видео

Показывает встроенные дорожки и сохраняет выбранную в SRT, VTT или ASS.

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

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

Скрипт читает список субтитров через ffprobe вместе с языками и названиями, затем извлекает нужную дорожку. Формат результата задаётся аргументом, по умолчанию используется SRT. Видео и звук не затрагиваются.

Запуск

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

python extract_subtitles.py movie.mkv --stream 0

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

Примеры

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

  • python extract_subtitles.py movie.mkv --stream 0
  • python extract_subtitles.py film.mp4 --format vtt
  • python extract_subtitles.py course.webm --stream 1 --output-dir subs
Зависимости

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

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

extract_subtitles.py

#!/usr/bin/env python3
"""Извлечение встроенных субтитров."""
from __future__ import annotations

import argparse
import json
import shutil
import subprocess
from pathlib import Path

CODECS = {"srt": "srt", "vtt": "webvtt", "ass": "ass"}


def subtitle_streams(path: Path) -> list[dict]:
    result = subprocess.run(
        [
            "ffprobe", "-v", "error", "-select_streams", "s",
            "-show_entries", "stream=index,codec_name:stream_tags=language,title",
            "-of", "json", str(path),
        ],
        capture_output=True,
        text=True,
        check=False,
    )
    if result.returncode != 0:
        raise SystemExit(f"ffprobe не смог прочитать {path}:\n{result.stderr.strip()}")
    return json.loads(result.stdout).get("streams", [])


def main() -> int:
    parser = argparse.ArgumentParser(description="Извлечь субтитры из видео")
    parser.add_argument("input", type=Path)
    parser.add_argument("--stream", type=int, default=0, help="Номер дорожки субтитров")
    parser.add_argument("--format", choices=tuple(CODECS), default="srt")
    parser.add_argument("--output-dir", type=Path, default=Path("subtitles"))
    parser.add_argument("--overwrite", action="store_true")
    args = parser.parse_args()

    if shutil.which("ffmpeg") is None:
        raise SystemExit("Не найден ffmpeg. Установите FFmpeg.")
    source = args.input.expanduser()
    if not source.is_file():
        parser.error(f"Файл не найден: {source}")

    streams = subtitle_streams(source)
    if not streams:
        raise SystemExit("В файле нет дорожек субтитров")
    print("Доступные дорожки:")
    for position, stream in enumerate(streams):
        tags = stream.get("tags", {})
        print(
            f"  {position}: index={stream.get('index')} "
            f"codec={stream.get('codec_name')} "
            f"language={tags.get('language', '?')} title={tags.get('title', '?')}"
        )
    if not 0 <= args.stream < len(streams):
        parser.error(f"Номер дорожки должен быть от 0 до {len(streams) - 1}")

    args.output_dir.mkdir(parents=True, exist_ok=True)
    target = args.output_dir / f"{source.stem}.{args.format}"
    if target.exists() and not args.overwrite:
        raise SystemExit(f"Файл уже существует: {target}. Добавьте --overwrite.")

    command = [
        "ffmpeg", "-hide_banner", "-nostdin", "-i", str(source),
        "-map", f"0:s:{args.stream}", "-c:s", CODECS[args.format],
        "-y" if args.overwrite else "-n", str(target),
    ]
    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-extract-subtitles
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

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

Категория

Видео

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