Видео

Собрать превью-сетку из видео

Делает одно изображение с кадрами через равные интервалы и настраиваемой сеткой.

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

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

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

Перед запуском
  • Сетка показывает только первые кадры, попавшие в выбранное число ячеек.
Запуск

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

python contact_sheet.py clip.mp4 --interval 15 --columns 4 --rows 3

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

Примеры

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

  • python contact_sheet.py clip.mp4 --interval 15 --columns 4 --rows 3
  • python contact_sheet.py movie.mkv --interval 60 --columns 5 --rows 4 --width 240
  • python contact_sheet.py talk.mp4 --output preview.jpg
Зависимости

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

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

contact_sheet.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("--interval", type=float, default=15.0, help="Секунды между кадрами")
    parser.add_argument("--columns", type=int, default=4)
    parser.add_argument("--rows", type=int, default=3)
    parser.add_argument("--width", type=int, default=320, help="Ширина одной ячейки")
    parser.add_argument("--output", "-o", type=Path, default=Path("preview.jpg"))
    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.interval <= 0:
        parser.error("Интервал должен быть больше нуля")
    if args.columns < 1 or args.rows < 1 or args.columns * args.rows > 64:
        parser.error("Сетка должна содержать от 1 до 64 ячеек")
    if args.width < 64 or args.width % 2:
        parser.error("Ширина ячейки должна быть чётной и не меньше 64")

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

    filters = (
        f"fps=1/{args.interval},scale={args.width}:-2,"
        f"tile={args.columns}x{args.rows}:padding=4:margin=4"
    )
    command = [
        "ffmpeg", "-hide_banner", "-nostdin", "-i", str(source),
        "-vf", filters, "-frames:v", "1", "-q:v", "3", "-update", "1",
        "-y" if args.overwrite else "-n", str(target),
    ]
    print(f"Сетка {args.columns}x{args.rows}, интервал {args.interval} с")
    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-contact-sheet
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

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

Категория

Видео

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