Quickstart

View Markdown

Install

Pick your preferred method:

# npm
npm i -g @ittybit/cli

# homebrew
brew install ittybit/tap/ittybit

# shell
curl -fsSL https://ittybit.com/install.sh | sh

Authenticate

Create an account and set your API key:

ittybit login

This opens your browser to create an account (or log in), generates an API key, and saves it to your environment.

You can also set it manually:

export ITTYBIT_API_KEY=your_api_key

Process your first file

ittybit video -i https://ittyb.it/sample.mp4 --quality high

That’s it. The file is sent to ittybit’s cloud infrastructure, processed on distributed GPUs, and the result is returned.

Try other media types:

# Extract a thumbnail
ittybit image -i https://ittyb.it/sample.mp4 --format webp

# Extract audio
ittybit audio -i https://ittyb.it/sample.mp4 --format mp3

# Create adaptive bitrate stream
ittybit adaptive -i https://ittyb.it/sample.mp4

Local processing

If you have FFmpeg installed, you can process files locally without an API key:

ittybit video -i input.mov -o output.mp4 --quality high --local

Check your local setup with:

ittybit health

Next steps