Tool Reference

Voca provides a rich command-line interface for controlling every aspect of your download. Below is a comprehensive guide to its usage and options.

Basic Usage

voca [options] <url>

Common Options

Option
Description
--output, -o <file>
Write output to <file> instead of default.
--recursive, -r
Turn on recursive retrieving.
--level, -l <number>
Maximum recursion depth (default: 5).
--no-clobber, -nc
Skip downloads that would download to existing files.
--continue, -c
Resume getting a partially-downloaded file.
--user-agent
Identify as <agent-string> to the HTTP server.
--header
Add a custom header to the request.

Examples

Recursive Mirror (Depth 1)

Download a page and all its immediate assets (images, scripts, styles).

voca --recursive --level=1 https://example.com

Authenticated Download

Use a cookies file exported from your browser to access protected content.

voca --load-cookies=cookies.txt https://example.com/secure-file.zip

Ignore SSL Errors

Useful for testing against local development servers with self-signed certificates.

voca --no-check-certificate https://localhost:8080