Собрать превью-сетку из видео
Делает одно изображение с кадрами через равные интервалы и настраиваемой сеткой.
Что делает скрипт
Скрипт выбирает кадры фильтром 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 3python contact_sheet.py movie.mkv --interval 60 --columns 5 --rows 4 --width 240python contact_sheet.py talk.mp4 --output preview.jpg
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
winget install Gyan.FFmpeg
brew install ffmpeg
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.