|
HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | CURL_OPTIONS | URL | EXAMPLES | AUTHORS | REPORTING BUGS | COPYRIGHT | SEE ALSO | COLOPHON |
|
|
|
wcurl(1) General Commands Manual wcurl(1)
wcurl - a simple wrapper around curl to easily download files.
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
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
supported 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.
--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 considered.
--no-decode-filename
Don't percent-decode the output filename, even if the
percent-encoding in the URL was done by wcurl, e.g.: The
URL contained whitespaces.
--dry-run
Do not actually execute curl, just print what would be
invoked.
-V, --version
Print version information.
-h, --help
Print help message.
Any option supported by curl can be set here. This is not used by
wcurl; it is instead forwarded to the curl invocation.
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.
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
Samuel Henrique <samueloph@debian.org>
Sergio Durigan Junior <sergiodj@debian.org>
and many contributors, see the AUTHORS file.
If you experience any problems with wcurl that you do not
experience with curl, submit an issue on Github:
https://github.com/curl/wcurl
wcurl is licensed under the curl license
curl(1), trurl(1)
This page is part of the curl (Command line tool and library for
transferring data with URLs) project. Information about the
project can be found at ⟨https://curl.haxx.se/⟩. If you have a
bug report for this manual page, see
⟨https://curl.haxx.se/docs/bugs.html⟩. This page was obtained
from the project's upstream Git repository
⟨https://github.com/curl/curl.git⟩ on 2025-08-11. (At that time,
the date of the most recent commit that was found in the
repository was 2025-08-10.) If you discover any rendering
problems in this HTML version of the page, or you believe there is
a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
man-pages@man7.org
wcurl 2025-08-09 wcurl(1)
|
HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|