Извлечь кадры из видео
Сохраняет стоп-кадры каждые N секунд в JPEG или PNG с необязательным масштабом.
Что делает скрипт
Скрипт использует фильтр fps, поэтому кадры идут равномерно по времени, а не по ключевым кадрам. Можно задать интервал, ширину и формат изображений. Папка назначения должна быть пустой, чтобы не смешивать старые и новые кадры.
Быстрый старт
python extract_frames.py clip.mp4 --every 5
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python extract_frames.py clip.mp4 --every 5python extract_frames.py lecture.mkv --every 30 --width 640python extract_frames.py demo.mov --every 0.5 --format png
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
winget install Gyan.FFmpeg
brew install ffmpeg
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.