Видео

Сделать GIF из видео с палитрой

Создаёт аккуратный GIF через palettegen и paletteuse без грязных цветов.

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

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

Скрипт сначала строит палитру по выбранному фрагменту, затем применяет её при сборке GIF. Можно задать начало, длительность, ширину и частоту кадров. Оригинальное видео не изменяется, готовый файл сохраняется отдельно.

Перед запуском
  • GIF получается заметно тяжелее видео при том же разрешении.
Запуск

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

python video_to_gif.py clip.mp4 --start 5 --duration 6

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

Примеры

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

  • python video_to_gif.py clip.mp4 --start 5 --duration 6
  • python video_to_gif.py demo.mov --width 640 --fps 20
  • python video_to_gif.py lecture.mkv --start 00:01:00 --duration 4 --output teaser.gif
Зависимости

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

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

video_to_gif.py

#!/usr/bin/env python3
"""Сборка GIF из видео с отдельной палитрой."""
from __future__ import annotations

import argparse
import shutil
import subprocess
import tempfile
from pathlib import Path


def parse_time(value: str) -> float:
    parts = value.split(":")
    try:
        if len(parts) == 1:
            return float(parts[0])
        if len(parts) == 2:
            return int(parts[0]) * 60 + float(parts[1])
        if len(parts) == 3:
            return int(parts[0]) * 3600 + int(parts[1]) * 60 + float(parts[2])
    except ValueError:
        pass
    raise argparse.ArgumentTypeError(f"Неверное время: {value}")


def duration_of(path: Path) -> float:
    result = subprocess.run(
        [
            "ffprobe", "-v", "error", "-show_entries", "format=duration",
            "-of", "default=noprint_wrappers=1:nokey=1", str(path),
        ],
        capture_output=True,
        text=True,
        check=False,
    )
    if result.returncode != 0:
        raise SystemExit(f"ffprobe не смог прочитать {path}:\n{result.stderr.strip()}")
    return float(result.stdout.strip())


def main() -> int:
    parser = argparse.ArgumentParser(description="Сделать GIF из фрагмента видео")
    parser.add_argument("input", type=Path)
    parser.add_argument("--start", type=parse_time, default=0.0)
    parser.add_argument("--duration", type=parse_time, default=10.0)
    parser.add_argument("--width", type=int, default=480)
    parser.add_argument("--fps", type=int, default=15)
    parser.add_argument("--output", "-o", type=Path)
    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.width < 64 or args.width % 2:
        parser.error("Ширина должна быть чётной и не меньше 64")
    if not 1 <= args.fps <= 50:
        parser.error("Частота кадров должна быть от 1 до 50")

    total = duration_of(source)
    if args.start >= total:
        parser.error(f"Начало за пределами ролика ({total:.1f} с)")
    duration = min(args.duration, total - args.start)
    if duration <= 0:
        parser.error("Длительность должна быть больше нуля")

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

    with tempfile.TemporaryDirectory(prefix="gif_") as temp_dir:
        palette = Path(temp_dir) / "palette.png"
        base_filter = f"fps={args.fps},scale={args.width}:-1:flags=lanczos"
        first = [
            "ffmpeg", "-hide_banner", "-nostdin",
            "-ss", f"{args.start:.3f}", "-t", f"{duration:.3f}", "-i", str(source),
            "-vf", f"{base_filter},palettegen=max_colors=256:stats_mode=diff",
            "-frames:v", "1", "-update", "1", "-y", str(palette),
        ]
        print("Построение палитры")
        result = subprocess.run(first, check=False)
        if result.returncode != 0:
            raise SystemExit(f"Не удалось построить палитру, код {result.returncode}")

        second = [
            "ffmpeg", "-hide_banner", "-nostdin",
            "-ss", f"{args.start:.3f}", "-t", f"{duration:.3f}", "-i", str(source),
            "-i", str(palette),
            "-lavfi",
            (
                f"{base_filter}[x];"
                "[x][1:v]paletteuse=dither=bayer:bayer_scale=5:diff_mode=rectangle"
            ),
            "-loop", "0", "-y" if args.overwrite else "-n", str(target),
        ]
        print(f"Сборка GIF: {duration:.1f} с, {args.width}px, {args.fps} fps")
        result = subprocess.run(second, check=False)
        if result.returncode != 0:
            raise SystemExit(f"ffmpeg завершился с кодом {result.returncode}")

    size_mb = target.stat().st_size / (1024 * 1024)
    print(f"Готово: {target} ({size_mb:.1f} МБ)")
    return 0


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

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

CLI 1.0.0

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

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

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

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

Категория

Видео

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