docs

Mave CLI

Manage videos and collections from your terminal with the Mave CLI. Upload a file, check your library or use JSON output in your scripts.

The CLI also works well with AI assistants that can run terminal commands. Its clear commands and JSON output let them upload and manage videos without first writing custom API scripts.

Install

Install with Homebrew on macOS or Linux:

brew install maveio/tap/mave

You can also download a standalone binary from GitHub releases.

Get started

mave login
mave videos list --format table
mave videos upload ./video.mp4 --wait
mave collections create --name "Product videos"

Login opens your browser to connect a Mave space and saves your login locally. Already logged in? The CLI reuses that login. Use mave logout to remove it.

Uploads accept a local file or a video file URL. Add --wait to wait until the video is playable. Commands return JSON by default; --format table makes lists easier to read.

Import from Vimeo

This feature is experimental.

Import your Vimeo videos with their titles and folder structure:

mave import vimeo --dry-run --format table
mave import vimeo

The first import guides you through creating a Vimeo access token and saves it for future imports. Transferring videos requires a Vimeo plan with API access to video files. Free accounts can preview titles and accessible folders with --dry-run.

Use --folder ID to select a Vimeo folder, or --resume to continue an interrupted import. Remove the saved Vimeo token with mave import vimeo logout.

Help and updates

mave --help
mave import vimeo --help
brew update
brew upgrade mave

See the command reference for all commands and options.

🍪 Press 'Accept' to confirm that you accept we don't use cookies. Yes, this banner is just for show!
Accept