CLI Reference
The CLI converts flags into FFmpeg commands. No network calls unless you opt in with --cloud. Process media on your own machine during development, then add --cloud to scale with zero code changes.
brew install ittybit/tap/ittybit
ittybit healthCommands
| Command | What it does |
|---|---|
video | Transcode, resize, trim, change codec |
audio | Extract audio from video, convert formats |
image | Convert images, extract frames from video |
adaptive | Create HLS adaptive bitrate streams |
step | Run a single operation (probe, ingest, encode, upload) |
tasks | Create or list tasks via the API |
connections | Manage S3 storage connections |
For the HTTP API equivalent of these commands, see the API Reference. The CLI accepts the same options as POST /tasks.
Global flags
| Flag | Short | Description |
|---|---|---|
--input | -i | Input file or URL |
--output | -o | Output file or S3 URL |
--json | Machine-readable JSONL output | |
--tty | Human-readable output | |
--cloud | Run on Ittybit infrastructure | |
--connection | S3 connection name | |
--debug | Show FFmpeg commands |
Output mode is auto-detected: terminal gets TTY, pipe gets JSON.