Skip to content

ittybit image

Convert images or create animated GIF/WebP clips

Convert an image or extract a frame from video. Use —end to create animated GIF/WebP clips.

Requires FFmpeg to be installed.

ittybit image [flags]
--background string Letterbox color for contain mode (e.g. #000000)
--end float Clip end time in seconds (enables animated output)
--fit string Resize behavior when both width and height are set: fill, contain, cover
--format string Output format: jpeg, png, webp, gif, avif
--fps float Frame rate for animated output (default: 10)
--height string Output height in pixels or percentage (e.g. 480 or 50%)
-h, --help help for image
--ingest Download file before processing (default: auto). Use --no-ingest to skip download. (default true)
-i, --input string Input file path or URL
--quality string Output quality: very_low, low, medium, high, very_high
--source string Pre-computed source metadata (JSON string, file path, or - for stdin). Skips probe step.
--start float Frame extraction time (static) or clip start (animated) in seconds
--width string Output width in pixels or percentage (e.g. 640 or 50%)
--cloud Run on Ittybit cloud infrastructure instead of locally
--connection string Connection name to use
--debug Show debug output including ffmpeg commands and stderr
--json Output as JSON
-o, --output string Output file path
--tty Output as human-readable text