image

ittybit image -i photo.png -o photo.webp

Converts between image formats, resizes, or extracts a frame from video. Use this to generate thumbnails, convert to modern formats like WebP, or pull poster frames for video players.

Options

FlagValuesDefault
--formatjpeg · png · webp · gif · avifper input
--qualityvery_low · low · medium · high · very_highauto
--widthpixels or "50%"same as input
--heightpixels or "50%"same as input
--fitcontain · cover · fill—
--backgroundhex color (e.g. #000000)—
--startseconds (frame time or clip start)0
--endseconds (enables animated output)—
--fpsframe rate for animated output10

Examples

Extract a poster frame from video:

ittybit image -i video.mp4 -o poster.jpg --start 5

Create a thumbnail:

ittybit image -i photo.jpg -o thumb.jpg --width 320 --quality medium

Convert to WebP:

ittybit image -i photo.png -o photo.webp

Output to S3:

ittybit image -i s3://bucket/raw/photo.png -o s3://bucket/thumbs/photo.webp --connection my-s3 --width 640

Cloud

Run on Ittybit infrastructure instead of locally:

ittybit image -i https://example.com/video.mp4 --cloud --start 5 --width 640

Requires ITTYBIT_API_KEY. The file is processed remotely and the output URL is returned.

See also