Skip to content
Ittybit

ittybit step video

Encode a video file

Synopsis

Section titled “Synopsis”

Encode a video file from a source object.

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

Input URL can be a local path, HTTP/HTTPS URL, or S3 URI. S3 URIs are resolved via ITTYBIT_S3_* env vars. Remote URLs are streamed directly when the server supports byte-range requests.

Requires -o (output path).

ittybit step video [flags]

Options

Section titled “Options”
      --background string   Letterbox color for contain mode
      --codec string        Video codec: h264, h265, vp9, av1
      --end float           Trim end time in seconds
      --fit string          Resize behavior: fill, contain, cover
      --format string       Output format: mp4, webm, mov
      --fps float           Output frame rate
      --frames int          Limit output to N video frames
      --height string       Output height in pixels or percentage
  -h, --help                help for video
  -i, --input string        Input as JSON source object (or - for stdin)
      --no-audio            Strip audio from output
      --quality string      Output quality: very_low, low, medium, high, very_high
      --start float         Trim start 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”