HH/.agents/skills/huashu-design/scripts/convert-formats.sh
ismail c5f76b3855
Some checks are pending
Build and Push Docker Image / build (push) Waiting to run
updates
2026-05-11 14:45:30 +03:00

84 lines
2.9 KiB
Bash
Executable File

#!/bin/bash
# Convert MP4 animations to 60fps MP4 and optimized GIF.
#
# Usage:
# ./convert-formats.sh input.mp4 [gif_width] [--minterpolate]
#
# Produces next to the input:
# <name>-60fps.mp4 (1920x1080, 60fps, frame-duplicated by default)
# <name>.gif (scaled width, 15fps, palette-optimized)
#
# Flags:
# --minterpolate Enable motion-compensated interpolation (high quality
# but elementary stream has known QuickTime/Safari
# compat issues — only use if your player handles it).
#
# Default 60fps mode: simple `fps=60` filter (frame duplication). Wide
# compatibility, plays in QuickTime / Safari / Chrome / VLC. The 60fps
# label is for upload-platform optics; perceived smoothness is identical
# to the source 25fps for most CSS-driven motion.
#
# When to enable --minterpolate: heavy translate/scale motion where you
# want true 60fps interpolation. WARN: macOS QuickTime sometimes refuses
# to open minterpolate output. Test before delivering.
#
# GIF uses two-pass palette:
# pass 1: palettegen with stats_mode=diff (per-video optimal palette)
# pass 2: paletteuse with bayer dither + rectangle diff
# This keeps 30s/1080p animations GIF under ~4MB with good color fidelity.
set -e
INPUT=""
GIF_WIDTH="960"
USE_MINTERPOLATE=0
for arg in "$@"; do
case "$arg" in
--minterpolate) USE_MINTERPOLATE=1 ;;
--*) echo "Unknown flag: $arg" >&2; exit 1 ;;
*)
if [ -z "$INPUT" ]; then INPUT="$arg"
else GIF_WIDTH="$arg"
fi
;;
esac
done
[ -z "$INPUT" ] && { echo "Usage: $0 input.mp4 [gif_width] [--minterpolate]" >&2; exit 1; }
DIR=$(dirname "$INPUT")
BASE=$(basename "$INPUT" .mp4)
OUT60="$DIR/$BASE-60fps.mp4"
OUTGIF="$DIR/$BASE.gif"
PAL="$DIR/.palette-$BASE.png"
if [ "$USE_MINTERPOLATE" = "1" ]; then
echo "▸ 60fps interpolate (minterpolate, high quality): $OUT60"
VFILTER="minterpolate=fps=60:mi_mode=mci:mc_mode=aobmc:me_mode=bidir:vsbmc=1"
else
echo "▸ 60fps frame-duplicate (compat mode): $OUT60"
VFILTER="fps=60"
fi
# -profile:v high -level 4.0 → broad H.264 compatibility (QuickTime, Safari, mobile)
# -movflags +faststart → moov atom upfront, streamable / instant-play
ffmpeg -y -loglevel error -i "$INPUT" \
-vf "$VFILTER" \
-c:v libx264 -pix_fmt yuv420p -profile:v high -level 4.0 \
-crf 18 -preset medium -movflags +faststart \
"$OUT60"
MP4_SIZE=$(du -h "$OUT60" | cut -f1)
echo "$MP4_SIZE"
echo "▸ GIF (${GIF_WIDTH}w, 15fps, palette-optimized): $OUTGIF"
# Pass 1: generate palette tailored to this video
ffmpeg -y -loglevel error -i "$INPUT" \
-vf "fps=15,scale=${GIF_WIDTH}:-1:flags=lanczos,palettegen=stats_mode=diff" \
"$PAL"
# Pass 2: apply palette with dithering
ffmpeg -y -loglevel error -i "$INPUT" -i "$PAL" \
-lavfi "fps=15,scale=${GIF_WIDTH}:-1:flags=lanczos[x];[x][1:v]paletteuse=dither=bayer:bayer_scale=5:diff_mode=rectangle" \
"$OUTGIF"
rm -f "$PAL"
GIF_SIZE=$(du -h "$OUTGIF" | cut -f1)
echo "$GIF_SIZE"