Видео

Извлечь кадры из видео

Сохраняет стоп-кадры каждые N секунд в JPEG или PNG с необязательным масштабом.

Python Windows macOS Linux Новичок
Скачать extract_frames.py
Описание

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

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

Запуск

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

python extract_frames.py clip.mp4 --every 5

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

Примеры

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

  • python extract_frames.py clip.mp4 --every 5
  • python extract_frames.py lecture.mkv --every 30 --width 640
  • python extract_frames.py demo.mov --every 0.5 --format png
Зависимости

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

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_frames.py

#!/usr/bin/env python3
"""Извлечение кадров из видео с заданным интервалом."""
from __future__ import annotations

import argparse
import shutil
import subprocess
from pathlib import Path


def main() -> int:
    parser = argparse.ArgumentParser(description="Извлечь кадры из видео")
    parser.add_argument("input", type=Path)
    parser.add_argument("--every", type=float, default=5.0, help="Интервал в секундах")
    parser.add_argument("--output-dir", type=Path, default=Path("frames"))
    parser.add_argument("--format", choices=("jpg", "png"), default="jpg")
    parser.add_argument("--width", type=int, help="Ширина кадра, высота подстроится")
    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}")
    if args.every <= 0:
        parser.error("Интервал должен быть больше нуля")
    if args.width is not None and (args.width < 16 or args.width % 2):
        parser.error("Ширина должна быть чётной и не меньше 16")

    args.output_dir.mkdir(parents=True, exist_ok=True)
    if any(args.output_dir.iterdir()) and not args.overwrite:
        raise SystemExit(f"Папка не пуста: {args.output_dir}. Добавьте --overwrite.")

    filters = [f"fps=1/{args.every}"]
    if args.width:
        filters.append(f"scale={args.width}:-2")
    pattern = args.output_dir / f"frame_%05d.{args.format}"
    command = [
        "ffmpeg", "-hide_banner", "-nostdin", "-i", str(source),
        "-vf", ",".join(filters),
    ]
    if args.format == "jpg":
        command += ["-q:v", "2"]
    command += ["-y" if args.overwrite else "-n", str(pattern)]

    print(f"Интервал: {args.every} с")
    result = subprocess.run(command, check=False)
    if result.returncode != 0:
        raise SystemExit(f"ffmpeg завершился с кодом {result.returncode}")
    count = len(list(args.output_dir.glob(f"frame_*.{args.format}")))
    print(f"Готово: {count} кадров в {args.output_dir}")
    return 0


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

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

CLI 1.0.0

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

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

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

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

Категория

Видео

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