vid2ani

Video to GIF/APNG/WEBP converter

A batch script for converting video files to GIF/APNG/WEBP using FFmpeg.

By MDHEXT, Nabi KaramAliZadeh, Pathduck

Based on the research listed here: High quality GIF with FFmpeg

Installation

Clone the repo.
Install FFmpeg.
For Windows make sure that the path to ffmpeg.exe is configured in your system environment variables control panel.

Usage

vid2ani [input_file] [arguments]

Arguments

  -o  Output file. Default is the same as input file, sans extension
  -t  Output file type: 'gif' (default), 'apng', 'png', 'webp'
  -r  Scale or size. Width of the animation in pixels
  -l  Enable lossy WebP compression and quality, range 0-100 (default 75)
  -f  Framerate in frames per seconds (default 15)
  -c  Maximum colors usable per palette, range 3-256 (default 256)
  -s  Start time of the animation (HH:MM:SS.MS)
  -e  End time of the animation (HH:MM:SS.MS)
  -d  Dithering algorithm to be used (default 0)
  -b  Bayer Scale setting, range 0-5 (default 2)
  -m  Palettegen mode: 1 (diff, default), 2 (single), 3 (full)
  -k  Enables paletteuse error diffusion
  -p  Opens the resulting animation in the default image viewer
  -v  Set FFmpeg log level (default: error)

Dithering Algorithms
  0: None
  1: Bayer
  2: Heckbert
  3: Floyd Steinberg
  4: Sierra2
  5: Sierra2_4a
  6: Sierra3
  7: Burkes
  8: Atkinson

Palettegen Modes
  1: diff - only what moves affects the palette
  2: single - one palette per frame
  3: full - one palette for the whole animation

About Bayerscale
When bayer dithering is selected, the Bayer Scale option defines the
scale of the pattern (how much the crosshatch pattern is visible).
A low value means more visible pattern for less banding, a higher value
means less visible pattern at the cost of more banding.

Notes

The script will attempt to check for valid inputs, but will fall back to FFmpeg's error messages.
The APNG muxer does not support multiple input palettes, palettegen (-m) will fall back to using diff mode if single mode is selected.
Since FFmpeg can convert between any format, it's also possible to convert between for instance GIF to WEBP, although frame rates might be off.
The script uses ffmpeg, you can download that here: FFmpeg
The script was forked from: MDHEXT/video2gif