69 lines
2.1 KiB
Groff
69 lines
2.1 KiB
Groff
.TH wcurl "1" "May 2024" "wcurl" "User Commands"
|
|
.SH NAME
|
|
.B wcurl
|
|
- a simple wrapper around curl for easily downloading files.
|
|
.SH SYNOPSIS
|
|
.nf
|
|
\fBwcurl [\-o|\-\-opts=\fI<CURL_OPTIONS>\fP...] \fI<URL>\fP...\fR
|
|
.fi
|
|
.SH DESCRIPTION
|
|
\fBwcurl\fR is a simple curl wrapper which lets you use curl to download files
|
|
without having to remember any parameters.
|
|
.PP
|
|
Simply call \fBwcurl\fR with a list of URLs you want to download and \fBwcurl\fR will pick
|
|
sane defaults.
|
|
.PP
|
|
If you need anything more fancy, you can provide any of curl's supported
|
|
parameters via the \fB\-o/\-\-opts\fR option.
|
|
.PP
|
|
.TP
|
|
By default, \fBwcurl\fR will:
|
|
.br
|
|
\[bu] Encode whitespaces in URLs;
|
|
.br
|
|
\[bu] Download multiple URLs in parallel;
|
|
.br
|
|
\[bu] Follow redirects;
|
|
.br
|
|
\[bu] Automatically chose a filename as output;
|
|
.br
|
|
\[bu] Perform retries;
|
|
.br
|
|
\[bu] Resume from broken/interrupted downloads.
|
|
.br
|
|
\[bu] Set the downloaded file timestamp to the value provided by the server, if available;
|
|
.SH OPTIONS
|
|
.TP
|
|
\fB\-o, \-\-opts=\fI<CURL_OPTIONS>\fR...\fR
|
|
Options to be passed to the curl invocation.
|
|
Note that all options needs to be passed as a single item, so you may
|
|
need to suround it with double quotes.
|
|
.SH CURL_OPTIONS
|
|
Any option supported by curl can be set here, this is not used by \fBwcurl\fR, it's
|
|
instead forwarded to the curl invocation.
|
|
.SH URL
|
|
Anything which is not a paremeter will be considered an URL.
|
|
\fBwcurl\fR will encode whitespaces and pass that to curl, which will perform the
|
|
parsing of the URL.
|
|
.SH EXAMPLES
|
|
Download a single file:
|
|
.br
|
|
\fBwcurl example.com/filename.txt\fR
|
|
.PP
|
|
Download two files in parallel:
|
|
.br
|
|
\fBwcurl example.com/filename1.txt example.com/filename2.txt\fR
|
|
.PP
|
|
Download a file passing the \fI\-\-progress\-bar\fR and \fI\-\-http2\fR flags to curl:
|
|
.br
|
|
\fBwcurl \-\-opts="\-\-progress\-bar \-http2" example.com/filename.txt\fR
|
|
.SH AUTHORS
|
|
Samuel Henrique <samueloph@debian.org>
|
|
.SH REPORTING BUGS
|
|
If you experience any problems with \fBwcurl\fR that you do not experience with curl,
|
|
submit an issue on the Debian Bug Tracking System.
|
|
.SH COPYRIGHT
|
|
\fBwcurl\fR is licensed under the MIT license
|
|
.SH SEE ALSO
|
|
.BR curl (1)
|