Links
Notes
- Config file:
~/.aria2/aria2.conf- The configuration file is a text file and has 1
option per each line. In each line, you can specify
name-value pair in the format:
NAME=VALUE, where name is the long command-line option name without--prefix. You can use same syntax for the command-line option. The lines beginning#are treated as comments.
- The configuration file is a text file and has 1
option per each line. In each line, you can specify
name-value pair in the format:
Snippets
| Flag | Description |
|---|---|
-i, --input-file=<FILE> |
Downloads URIs listed in FILE. You can specify multiple sources for a single entity by putting multiple URIs on a single line separated by the <TAB> character. Indented lines following a URI can be used to specify options as name=value pairs with one option per line (e.g. out=filename.tgz). See Input File subsection for details. |
-j, --max-concurrent-downloads=<N> |
Max concurrent connections per host. See also --split option. Default: 5 |
-x, --max-connection-per-server=<NUM> |
The maximum number of connections to one server for each download. Default: 1 |
-s, --split=<N> |
Download a file using N connections. If more than N URIs are given, first N URIs are used and remaining URIs are used for backup. If less than N URIs are given, those URIs are used more than once so that N connections total are made simultaneously. The number of connections to the same host is restricted by --max-connection-per-server option. See also --min-split-size option. Default: 5 |
-Z, --force-sequential[=true/false] |
Fetch URIs in the command-line sequentially and download each URI in a separate session, like the usual command-line download utilities. Default: false |
-P, --parameterized-uri[=true/false] |
Enable parameterized URI support. You can specify set of parts: http://{sv1,sv2,sv3}/foo.iso. Also you can specify numeric sequences with step counter: http://host/image[000-100:2].img. A step counter can be omitted. If all URIs do not point to the same file, such as the second example above, -Z option is required. Default: false |
--header=<HEADER> |
Append HEADER to HTTP request header. You can use this option repeatedly to specify more than one header |
--http-no-cache[=true/false] |
Send Cache-Control: no-cache and Pragma: no-cache header to avoid cached content. If false is given, these headers are not sent and you can add Cache-Control header with a directive you like using --header option. Default: false |
--on-download-complete=<COMMAND> |
|
--on-download-error=<COMMAND> |
|
--on-download-stop=<COMMAND> |
Command to either either on download complete or error. If --on-download-complete/--on-download-error are specified, this option is ignored. |
--on-download-start=<COMMAND> |
|
--on-download-pause=<COMMAND> |
|
--log-level=[debug/info/notice/warn/error] |
default: debug |
--console-log-level=[debug/info/notice/warn/error] |
default: notice |
--log=<LOGFILE> |
log to logfile |
Shell
# You can use Firefox/Mozilla/Chromium's cookie file without modification. aria2c --load-cookies=cookies.txt http://host/file # Client certificate authorization. # PKCS12 file with no password. aria2c --certificate=/path/to/mycert.p12 https://host/file # If .pem files are supported, aria2c --certificate=/path/to/mycert.pem --private-key=/path/to/private_key.pem https://host/file # Verify peer in SSL/TLS using given CA certificates. aria2c --ca-certificate=/path/to/ca-certificates.crt --check-certificate https://host/file # Verify checksum of downloaded file. aria2c --checksum=sha-1=0192ba11326fe2298c8cb4de616f4d4140213837 http://example.org/file # Pass custom header aria2c --header='X-Foo: FooValue' http://localhost:8000/hello.hello