Saving files & output

Saving a render: --output

Pass --output to save the rendered file to disk:

urlbox screenshot https://example.com --output out/shot.png

For safety, --output is sandboxed to your current working directory: paths outside it, .. escapes, and existing symlinks at the target are rejected, so a wrong or unexpected path can't overwrite an unrelated file. To write somewhere else, change directory there first:

cd ~/screenshots && urlbox screenshot https://example.com --output shot.png

Without --output, the result, including the hosted render URL, is printed instead of saved.

Output format

Each command can print its result in three shapes, set with --output-format:

• text — a human-readable summary (the default in your terminal).
• json — the full result, including the render URL and metadata.
• quiet — just the essential data, with no surrounding detail.

urlbox screenshot https://example.com --output-format json

If you only want one field from the result, --jq filters it inline. For example, to print just the hosted render URL:

urlbox render https://example.com --output-format quiet --jq '.renderUrl'