Сделать GIF из видео с палитрой
Создаёт аккуратный GIF через palettegen и paletteuse без грязных цветов.
Что делает скрипт
Скрипт сначала строит палитру по выбранному фрагменту, затем применяет её при сборке 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 6python video_to_gif.py demo.mov --width 640 --fps 20python video_to_gif.py lecture.mkv --start 00:01:00 --duration 4 --output teaser.gif
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
winget install Gyan.FFmpeg
brew install ffmpeg
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.