Skip to content
Ittybit

ittybit step image

Extract or convert an image

Synopsis

Section titled “Synopsis”

Extract or convert an image from a source object.

Input must be a JSON source object (from probe or ingest output): ittybit step image -i ’{“object”:“source”,“kind”:“image”,“url”:”…”,“width”:1920,…}’ -o output.jpg

Input URL can be a local path, HTTP/HTTPS URL, or S3 URI.

Requires -o (output path).

ittybit step image [flags]

Options

Section titled “Options”
      --background string   Letterbox color for contain mode
      --fit string          Resize behavior: fill, contain, cover
      --format string       Output format: jpeg, png, webp, gif, avif
      --height string       Output height in pixels or percentage
  -h, --help                help for image
  -i, --input string        Input as JSON source object (or - for stdin)
      --quality string      Output quality: very_low, low, medium, high, very_high
      --start float         Frame extraction time in seconds
      --width string        Output width in pixels or percentage

Options inherited from parent commands

Section titled “Options inherited from parent commands”
      --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

SEE ALSO

Section titled “SEE ALSO”