FreeBSD Manual Pages
wcurl(1) General Commands Manual wcurl(1) NAME wcurl - a simple wrapper around curl to easily download files. SYNOPSIS wcurl <URL>... wcurl [--curl-options <CURL_OPTIONS>]... [--dry-run] [--no-decode-file- name] [-o|-O|--output <PATH>] [--] <URL>... wcurl [--curl-options=<CURL_OPTIONS>]... [--dry-run] [--no-decode-file- name] [--output=<PATH>] [--] <URL>... wcurl -V|--version wcurl -h|--help DESCRIPTION wcurl is a simple curl wrapper which lets you use curl to download files without having to remember any parameters. Simply call wcurl with a list of URLs you want to download and wcurl picks sane defaults. If you need anything more complex, you can provide any of curl's sup- ported parameters via the --curl-options option. Just beware that you likely should be using curl directly if your use case is not covered. By default, wcurl does: * Percent-encode whitespaces in URLs; * Download multiple URLs in parallel if the installed curl's version is >= 7.66.0 (--parallel); * Follow redirects; * Automatically choose a filename as output; * Avoid overwriting files if the installed curl's version is >= 7.83.0 (--no-clobber); * Perform retries; * Set the downloaded file timestamp to the value provided by the server, if available; * Default to https if the URL does not contain any scheme; * Disable curl's URL globbing parser so {} and [] characters in URLs are not treated specially; * Percent-decode the resulting filename; * Use 'index.html' as the default filename if there is none in the URL. OPTIONS --curl-options, --curl-options=<CURL_OPTIONS>... Specify extra options to be passed when invoking curl. May be specified more than once. -o, -O, --output, --output=<PATH> Use the provided output path instead of getting it from the URL. If multiple URLs are provided, resulting files share the same name with a number appended to the end (curl >= 7.83.0). If this option is provided multiple times, only the last value is con- sidered. --no-decode-filename Don't percent-decode the output filename, even if the per- cent-encoding in the URL was done by wcurl, e.g.: The URL con- tained whitespaces. --dry-run Do not actually execute curl, just print what would be invoked. -V, --version Print version information. -h, --help Print help message. CURL_OPTIONS Any option supported by curl can be set here. This is not used by wcurl; it is instead forwarded to the curl invocation. URL URL to be downloaded. Anything that is not a parameter is considered an URL. Whitespaces are percent-encoded and the URL is passed to curl, which then performs the parsing. May be specified more than once. EXAMPLES Download a single file: wcurl example.com/filename.txt Download two files in parallel: wcurl example.com/filename1.txt example.com/filename2.txt Download a file passing the --progress-bar and --http2 flags to curl: wcurl --curl-options="--progress-bar --http2" example.com/filename.txt Resume from an interrupted download (if more options are used, this needs to be the last one in the list): wcurl --curl-options="--continue-at -" example.com/filename.txt AUTHORS Samuel Henrique <samueloph@debian.org> Sergio Durigan Junior <sergiodj@debian.org> and many contributors, see the AUTHORS file. REPORTING BUGS If you experience any problems with wcurl that you do not experience with curl, submit an issue on Github: https://github.com/curl/wcurl COPYRIGHT wcurl is licensed under the curl license SEE ALSO curl(1), trurl(1) wcurl 2025-11-01 wcurl(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | CURL_OPTIONS | URL | EXAMPLES | AUTHORS | REPORTING BUGS | COPYRIGHT | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=wcurl&sektion=1&manpath=FreeBSD+Ports+15.0>