Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
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-filename]
     [-o|-O|--output <PATH>] [--] <URL>...

     wcurl [--curl-options=<CURL_OPTIONS>]... [--dry-run] [--no-decode-filename]
     [--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.

     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 supported
     parameters via the --curl-options option. Beware that you likely should  be
     using curl directly if your use case is not covered.

     By default, wcurl does:

     * Percent-encode whitespace in URLs;

     * Download multiple URLs in parallel
	    if the installed curl's version is >= 7.66.0 (--parallel);

     * Use a total number of 5 parallel connections to the same protocol + host-
     name + port number target
	    if the installed curl's version is >= 8.16.0 (--parallel-max-host);

     * 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 speci-
	    fied 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 considered.

     --no-decode-filename
	    Do	not  percent-decode the output filename, even if the percent-en-
	    coding in the URL was done by wcurl, e.g.: The URL contained  white-
	    space.

     --dry-run
	    Do not actually execute curl, 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. Whitespace is 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. The options necessary to resume the
     download (--clobber --continue-at -) must be the last options specified  in
     --curl-options.   Note that the only way to resume interrupted downloads is
     to allow wcurl to overwrite the destination file:

     wcurl --curl-options="--clobber --continue-at -" example.com/filename.txt

     Download multiple files without a limit of concurrent connections per  host
     (the default limit is 5):

     wcurl  --curl-options="--parallel-max-host 0" example.com/filename1.txt ex-
     ample.com/filename2.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				   2026-06-11				wcurl(1)

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.1.quarterly>

home | help