Skip to content

docs(cli): storage commands and --deliver #90

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
a-essawy merged 2 commits into from
Sep 13, 2026
Merged

docs(cli): storage commands and --deliver #90

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
dfa3d10
docs(cli): storage commands and --deliver
a-essawy Sep 13, 2026
cf4751c
docs(cli): rb storage needs a fresh sign in
a-essawy Sep 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 9 additions & 2 deletions cli.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ canonical: "https://rendobar.com/docs/cli"
"headline": "Run FFmpeg from your terminal",
"description": "Install the rb binary, sign in, and run any ffmpeg command in the cloud from your shell. Local files upload and download for you.",
"datePublished": "2026-06-22",
"dateModified": "2026-06-22",
"dateModified": "2026-09-13",
"author": { "@type": "Organization", "@id": "https://rendobar.com/#organization" },
"publisher": { "@type": "Organization", "@id": "https://rendobar.com/#organization" },
"isPartOf": { "@id": "https://rendobar.com/#website" }
Expand Down Expand Up @@ -91,6 +91,8 @@ Get an API key from [app.rendobar.com](https://app.rendobar.com) under Settings,
| Command | What it does |
|---|---|
| `rb ffmpeg <args>` | Run FFmpeg in the cloud. Pass real `ffmpeg` flags. Local `-i` inputs upload automatically |
| `rb storage list` | List the buckets connected on the [Storage page](https://app.rendobar.com/storage) |
| `rb storage ls <id>[/folder]` | List folders and files in a connected bucket, each with its `storage://` URI. `--all` reads every page |
| `rb login [--key <key>]` | Sign in via browser OAuth, or save an API key with `--key` |
| `rb logout` | Revoke the token and delete the credential file |
| `rb whoami` | Print the current org, plan, and balance |
Expand All @@ -108,15 +110,20 @@ These flags belong to `rb ffmpeg`. Everything else after the subcommand passes t
| `--quiet` | Print nothing. Read the exit code |
| `--no-wait` | Submit and exit, printing the job ID |
| `--timeout N` | Server-side execution timeout in seconds. Range 1 to 900, default 120 |
| `--deliver <uri>` | Also write the output to connected storage, for example `storage://prod-media/exports`. Repeat for more buckets. Also on `rb generate` and `rb edit` |

Local inputs (`-i ./clip.mp4`) upload before submission and are rewritten to short-lived URLs. Remote inputs (`-i https://...`) pass through untouched. The trailing output filename is where the result downloads to.

A delivery starts after the job completes. rb waits up to five minutes for it and prints where each one landed.

`rb storage` needs storage access. If you signed in before rb asked for it, run `rb login` again, or use an API key made on or after September 13, 2026.

### Exit codes

| Code | Meaning |
|---|---|
| `0` | Success |
| `1` | Job failed, or a generic runtime error |
| `1` | Job failed, a delivery did not land, or a generic runtime error |
| `2` | Not authenticated, bad arguments, port in use, or insufficient credits |
| `130` | Cancelled with `Ctrl+C`. The CLI tries to cancel the in-flight job first |

Expand Down
Loading