| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771 | 
							- ARIA2C(1)
 
- =========
 
- Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
 
- NAME
 
- ----
 
- aria2c - The ultra fast download utility
 
- SYNOPSIS
 
- --------
 
- 'aria2c' [OPTIONS] URL|TORRENT_FILE|METALINK_FILE ...
 
- DESCRIPTION
 
- -----------
 
- aria2 is a utility for downloading files. The supported protocols are HTTP(S), FTP, BitTorrent, and Metalink. It has a powerful segmented downloading ability, downloading a file from multiple sources and multiple protocols and utilizing your download bandwidth to the maximum. It supports downloading a file from HTTP(S)/FTP and BitTorrent at the same time, while the data downloaded from HTTP(S)/FTP is uploaded to the BitTorrent swarm. Using Metalink's chunk checksums, aria2 automatically validates chunks of data while downloading a file like BitTorrent.
 
- OPTIONS
 
- -------
 
- Basic Options
 
- ~~~~~~~~~~~~~
 
- -d, --dir=DIR::
 
-   The directory to store the downloaded file.
 
- -i, --input-file=FILE::
 
-   Downloads URIs found in FILE. You can specify multiple URIs for a single
 
-   entity: separate URIs on a single line using the TAB character.
 
-   Reads input from stdin when '-' is specified.
 
- -l, --log=LOG::
 
-   The file name of the log file. If '-' is specified, log is written to
 
-   stdout.
 
- -j, --max-concurrent-downloads=N::
 
-   Set maximum number of parallel downloads.
 
-   Default: '1'
 
- --check-integrity='true'|'false'::
 
-   Check file integrity by validating piece hash.
 
-   This option only affects in BitTorrent downloads and Metalink downloads with
 
-   chunk checksums.
 
-   Use this option to re-download a damaged portion of a file.
 
-   Default: 'false'
 
- -c, --continue::
 
-    Continue downloading a partially downloaded file.
 
-    Use this option to resume a download started by a web browser or another
 
-    program which downloads files sequentially from the beginning.
 
-    Currently this option is only applicable to HTTP(S)/FTP downloads.
 
- -h, --help[=CATEGORY]::
 
-   Print usage and exit.
 
-   The help messages are classified in several categories.
 
-   For example, type "--help=http" for detailed explanation for the options
 
-   related to HTTP. If no matching category is found, search option name using
 
-   a given word in forward match and print the result.
 
-   Available Values: 'basic', 'advanced', 'http', 'ftp', 'metalink',
 
-   'bittorrent', 'all'
 
-   Default: 'basic'
 
- HTTP/FTP Options
 
- ~~~~~~~~~~~~~~~~
 
- --lowest-speed-limit=SPEED::
 
-   Close connection if download speed is lower than or equal to this
 
-   value(bytes per sec).
 
-   '0' means aria2 does not have a lowest speed limit.
 
-   You can append 'K' or 'M'(1K = 1024, 1M = 1024K).
 
-   This option does not affect BitTorrent downloads.
 
-   Default: '0'
 
- -m, --max-tries=N::
 
-   Set number of tries. '0' means unlimited.
 
-   Default: '5'
 
- -o, --out=FILE::
 
-   The file name of the downloaded file.
 
- [NOTE]
 
- In Metalink, BitTorrent download you cannot specify file name.
 
- The file name specified here is only used when the URLs fed to aria2
 
- is done by command line without -i, -Z option, like this:
 
- aria2c -o myfile.zip http://mirror1/file.zip http://mirror2/file.zip
 
- --retry-wait=SEC::
 
-   Set the seconds to wait to retry after an error has occured.
 
-   Specify a value between '0' and '60'.
 
-   Default: '5'
 
- -s, --split=N::
 
-   Download a file using N connections. N must be between '1' and '5'.
 
-   This option affects all URLs. Thus, aria2 connects to each URL with N
 
-   connections.
 
-   Default: '1'
 
- -t, --timeout=SEC::
 
-   Set timeout in seconds.
 
-   Default: '60'
 
- HTTP Specific Options
 
- ~~~~~~~~~~~~~~~~~~~~~
 
- --http-auth-scheme=SCHEME::
 
-   Set HTTP authentication scheme.
 
-   Currently, 'basic' is the only supported scheme.
 
-   Default: 'basic'
 
- --http-user=USER::
 
-   Set HTTP user. This affects all URLs.
 
- --http-passwd=PASSWD::
 
-   Set HTTP password. This affects all URLs.
 
- --http-proxy=HOST:PORT::
 
-   Use HTTP proxy server. This affects all URLs.
 
- --http-proxy-user=USER::
 
-   Set HTTP proxy user. This affects all URLs.
 
- --http-proxy-passwd=PASSWD::
 
-   Set HTTP proxy password. This affects all URLs.
 
- --http-proxy-method=METHOD::
 
-   Set the method to use in proxy request.
 
-   'METHOD' is either 'get' or 'tunnel'.
 
-   Default: 'tunnel'
 
- --referer=REFERER::
 
-   Set Referer. This affects all URLs.
 
- --enable-http-keep-alive[='true'|'false']::
 
-   Enable HTTP/1.1 persistent connection.
 
-   Default: 'true'
 
- --enable-http-pipelining[='true'|'false']::
 
-   Enable HTTP/1.1 pipelining.
 
-   Default: 'false'
 
- --header=HEADER::
 
-   Append HEADER to HTTP request header.
 
-   You can use this option repeatedly to specify more than one header:
 
-   aria2c --header="X-A: b78" --header="X-B: 9J1" http://host/file
 
- --load-cookies=FILE::
 
-   Load cookies from FILE.
 
-   The format of FILE is the same used by Netscape and Mozilla.
 
- -U, --user-agent=USER_AGENT::
 
-   Set user agent for HTTP(S) downloads.
 
- FTP Specific Options
 
- ~~~~~~~~~~~~~~~~~~~~
 
- --ftp-user=USER::
 
-   Set FTP user. This affects all URLs.
 
-   Default: 'anonymous'
 
- --ftp-passwd=PASSWD::
 
-   Set FTP password. This affects all URLs.
 
-   Default: 'ARIA2USER@'
 
- -p, --ftp-pasv::
 
-   Use passive mode in FTP.
 
- --ftp-type=TYPE::
 
-   Set FTP transfer type. TYPE is either 'binary' or 'ascii'.
 
-   Default: 'binary'
 
- --ftp-reuse-connection[='true'|'false']::
 
-   Reuse connection in FTP.
 
-   Default: 'true'
 
- --ftp-via-http-proxy=METHOD::
 
-   Use HTTP proxy in FTP. METHOD is either 'get' or 'tunnel'.
 
-   Default: 'tunnel'
 
- -n, --no-netrc::
 
-   Disables netrc support. netrc support is enabled by default.
 
- BitTorrent/Metalink Options
 
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
- --select-file=INDEX...::
 
-   Set file to download by specifing its index.
 
-   You can find the file index using the --show-files option.
 
-   Multiple indexes can be specified by using ",", for example: '3,6'.
 
-   You can also use "-" to specify a range: '1-5'.
 
-   "," and "-" can be used together: '1-5,8,9'.
 
-   When used with the -M option, index may vary depending on the query
 
-   (see --metalink-* options).
 
- [NOTE]
 
- In multi file torrent, the adjacent files specified by this option may
 
- also be downloaded. This is by design, not a bug.
 
- A single piece may include several files or part of files, and aria2
 
- writes the piece to the appropriate files.
 
- -S, --show-files::
 
-   Print file listing of .torrent or .metalink file and exit.
 
-   In case of .torrent file, additional information
 
-   (infohash, piece length, etc) is also printed.
 
- BitTorrent Specific Options
 
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
- --bt-min-crypto-level='plain'|'arc4'::
 
-   Set minimum level of encryption method.
 
-   If several encryption methods are provided by a peer, aria2 chooses a lowest
 
-   one which satisfies the given level.
 
-   Default: 'plain'
 
- --bt-require-crypto='true'|'false'::
 
-   If true is given, aria2 doesn't accept and establish connection with legacy
 
-   BitTorrent handshake(\19BitTorrent protocol).
 
-   Thus aria2 always uses Obfuscation handshake.
 
-   Default: 'false' 
 
- --dht-entry-point=HOST:PORT::
 
-   Set host and port as an entry point to DHT network.
 
- --dht-listen-port=PORT...::
 
-   Set UDP listening port for DHT.
 
-   Multiple ports can be specified by using ",", for example: '6881,6885'.
 
-   You can also use "-" to specify a range: '6881-6999'. "," and "-" can be used
 
-   together.
 
-   Default: '6881-6999'
 
- --direct-file-mapping='true'|'false'::
 
-   Directly read from and write to each file mentioned in .torrent file.
 
-   Use this option if lots of files are listed in .torrent file and aria2
 
-   complains it cannot open files anymore.
 
-   Default: 'true'
 
- --enable-dht[='true'|'false']::
 
-   Enable DHT functionality. If a private flag is set in a torrent, aria2
 
-   doesn't use DHT for that download even if 'true' is given.
 
-   Default: 'false'
 
- --enable-peer-exchange[='true'|'false']::
 
-   Enable Peer Exchange extension. If a private flag is set in a torrent, this
 
-   feature is disabled for that download even if 'true' is given.
 
-   Default: 'true'
 
- --follow-torrent='true'|'false'|'mem'::
 
-   If 'true' or 'mem' is specified, when a file whose suffix is ".torrent" or content
 
-   type is "application/x-bittorrent" is downloaded, aria2 parses it as a torrent
 
-   file and downloads files mentioned in it.
 
-   If 'mem' is specified, a torrent file is not written to the disk, but is just
 
-   kept in memory.
 
-   If 'false' is specified, the action mentioned above is not taken.
 
-   Default: 'true'
 
- --listen-port=PORT...::
 
-   Set TCP port number for BitTorrent downloads.
 
-   Multiple ports can be specified by using ",",  for example: '6881,6885'.
 
-   You can also use "-" to specify a range: '6881-6999'.
 
-   "," and "-" can be used together: '6881-6889,6999'.
 
-   Default: '6881-6999'
 
- [NOTE]
 
- Make sure that the specified ports are open for incoming TCP traffic.
 
- --max-upload-limit=SPEED::
 
-   Set max upload speed in bytes per sec. '0' means unrestricted.
 
-   You can append 'K' or 'M'(1K = 1024, 1M = 1024K).
 
-   Default: '0'
 
- --peer-id-prefix=PEERI_ID_PREFIX::
 
-   Specify the prefix of peer ID. The peer ID in BitTorrent is 20 byte length.
 
-   If more than 20 bytes are specified, only first 20 bytes are used.
 
-   If less than 20 bytes are specified, the random alphabet characters are
 
-   added to make it's length 20 bytes.
 
-   Default: '-aria2-'
 
- --seed-ratio=RATIO::
 
-   Specify share ratio. Seed completed torrents until share ratio reaches]
 
-   RATIO.
 
-   I strongly encourages you to specify equals or more than '1.0' here.
 
-   Specify '0.0' if you intend to do seeding regardless of share ratio.
 
-   If --seed-time option is specified along with this option, seeding ends when
 
-   at least one of the conditions is satisfied.
 
-   Default: '1.0'
 
- --seed-time=MINUTES::
 
-   Specify seeding time in minutes. Also see the --seed-ratio option.
 
- -T, --torrent-file=TORRENT_FILE::
 
-   The path to the .torrent file.
 
-   You may not use this option because you can specify torrent file without -T.
 
- Metalink Specific Options
 
- ~~~~~~~~~~~~~~~~~~~~~~~~~
 
- --follow-metalink='true'|'false'|'mem'::
 
-   If 'true' or 'mem' is specified, when a file whose suffix is ".metaink" or content
 
-   type is "application/metalink+xml" is downloaded, aria2 parses it as a metalink
 
-   file and downloads files mentioned in it.
 
-   If 'mem' is specified, a metalink file is not written to the disk, but is just
 
-   kept in memory.
 
-   If 'false' is specified, the action mentioned above is not taken.
 
-   Default: 'true'
 
- -M, --metalink-file=METALINK_FILE::
 
-   The file path to .metalink file. You may not use this option because you can
 
-   specify metalink file without -M.
 
- -C, --metalink-servers=NUM_SERVERS::
 
-   The number of servers to connect to simultaneously.
 
-   Some metalinks regulates the number of servers to connect.
 
-   aria2 respects them.
 
-   Default: '1'
 
- --metalink-language=LANGUAGE::
 
-   The language of the file to download.
 
- --metalink-location=LOCATION[,...]::
 
-   The location of the preferred server.
 
-   A comma-deliminated list of locations is acceptable, for example, 'JP,US'.
 
- --metalink-os=OS::
 
-   The operating system of the file to download.
 
- --metalink-version=VERSION::
 
-   The version of the file to download.
 
- --metalink-preferred-protocol=PROTO::
 
-   Specify preferred protocol.
 
-   The possible values are 'http', 'https', 'ftp' and 'none'.
 
-   Specifiy 'none' to disable this feature.
 
-   Default: 'none'
 
-  
 
- --metalink-enable-unique-protocol='true'|'false'::
 
-   If 'true' is given and several protocols are available for a mirror in a
 
-   metalink file, aria2 uses one of them.
 
-   Use --metalink-preferred-protocol option to specify the preference of
 
-   protocol.
 
-   Default: 'true'
 
- Advanced Options
 
- ~~~~~~~~~~~~~~~~
 
- --allow-overwrite='true'|'false'::
 
-   If 'false' is given, aria2 doesn't download a file which already exists but
 
-   the corresponding .aria2 file doesn't exist.
 
-   In HTTP(S)/FTP download, if --auto-file-renaming='true' then,
 
-   file name will be renamed. See --auto-file-renaming for details.
 
-   Default: 'false'
 
- --allow-piece-length-change='true'|'false'::
 
-   If false is given, aria2 aborts download when a piece length is different
 
-   from one in a control file.
 
-   If true is given, you can proceed but some download progress will be lost.
 
-   Default: 'false'
 
- --async-dns[='true'|'false']::
 
-   Enable asynchronous DNS.
 
-   Default: 'true'
 
- --auto-file-renaming[='true'|'false']::
 
-   Rename file name if the same file already exists.
 
-   This option works only in HTTP(S)/FTP download.
 
-   The new file name has a dot and a number(1..9999) appended.
 
-   Default: 'true'
 
- --conf-path=PATH::
 
-   Change the configuration file path to PATH.
 
-   Default: '$HOME/.aria2/aria2.conf'
 
- -D, --daemon::
 
-   Run as daemon.
 
- --enable-direct-io[='true'|'false']::
 
-   Enable directI/O, which lowers cpu usage while allocating/checking files.
 
-   Turn off if you encounter any error.
 
-   Default: 'false'
 
- --file-allocation=METHOD::
 
-   Specify file allocation method. METHOD is either 'none' or 'prealloc'.
 
-   'none' doesn't pre-allocate file space. 'prealloc' pre-allocates file space
 
-   before download begins. This may take some time depending on the size of the
 
-   file.
 
-   Default: 'prealloc'
 
- [NOTE]
 
- In multi file torrent, the files adjacent forward to the specified files
 
- are also allocated if they share a same piece.
 
- -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'
 
- --max-download-limit=SPEED::
 
-    Set max download speed in bytes per sec. '0' means unrestricted.
 
-    You can append 'K' or 'M'(1K = 1024, 1M = 1024K).
 
-    Default: '0'
 
- --no-conf::
 
-   Disable loading aria2.conf file.
 
- --no-file-allocation-limit=SIZE::
 
-   No file allocation is made for files whose size is smaller than SIZE.
 
-   You can append 'K' or 'M'(1K = 1024, 1M = 1024K).
 
-   Default: '5M'
 
- -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'
 
- -q, --quiet[='true'|'false']::
 
-   Make aria2 quite (no console output).
 
-   Default: 'false'
 
- --realtime-chunk-checksum='true'|'false'::
 
-    Validate chunk of data by calculating checkusm while download a file if
 
-    chunk checksums are provided. Currently Metalink is the only way to to
 
-    provide chunk checksums.
 
-    Default: 'true'
 
- --stop=SEC::
 
-   Stop application after SEC seconds has passed.
 
-   If '0' is given, this feature is disabled.
 
-   Default: '0'
 
-  
 
- -v, --version::
 
-   Print the version number, copyright and the configuration information and
 
-   exit.
 
- URL, TORRENT_FILE, METALINK_FILE
 
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
- You can specify multiple URLs in command-line.
 
- Unless you specify -Z option, all URLs must point to the same file or downloading will fail.
 
- You can also specify arbitrary number of torrent files and metalink files
 
- stored in a local drive. Please note that they are always treated as a
 
- separate download.
 
- You can specify both torrent file with -T option and URLs. By doing this,
 
- download a file from both torrent swarm and HTTP(S)/FTP server at the same time,
 
- while the data from HTTP(S)/FTP are uploaded to the torrent swarm. Note that
 
- only single file torrent can be integrated with HTTP(S)/FTP.
 
- [NOTE]
 
- Make sure that URL is quoted with single(\') or double(") quotation if it
 
- contains "&" or any characters that have special meaning in shell.
 
- EXAMPLES
 
- --------
 
- HTTP/FTP Segmented Download
 
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
- Download a file using 1 connection
 
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
- ----------------------------------
 
- aria2c http://host/file.zip
 
- ----------------------------------
 
- [NOTE]
 
- To pause a download, press Ctrl-C. You can resume the transfer by running aria2c with the same argument at the same directory. You can change URLs as long as they are pointing to the same file.
 
- Download a file using 2 connections
 
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
- --------------------------------
 
- aria2c -s2 http://host/file.zip
 
- --------------------------------
 
- Download a file from 2 different HTTP servers
 
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
- --------------------------------------------------
 
- aria2c http://host/file.zip http://mirror/file.zip
 
- --------------------------------------------------
 
- Download a file from HTTP and FTP servers
 
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
- -------------------------------------------------
 
- aria2c http://host1/file.zip ftp://host2/file.zip
 
- -------------------------------------------------
 
- Download files listed in a file concurrently
 
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
- ------------------------
 
- aria2c -ifiles.txt -j2
 
- ------------------------
 
- [NOTE]
 
- -j option specifies the number of parallel downloads.
 
- Metalink Download
 
- ~~~~~~~~~~~~~~~~~
 
- Download files with remote Metalink
 
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
- ------------------------------------------------------
 
- aria2c --follow-metalink=mem http://host/file.metalink
 
- ------------------------------------------------------
 
- Download using a local metalink file
 
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
- ----------------------------------------------------------
 
- aria2c -p --lowest-speed-limit=4000 file.metalink
 
- ----------------------------------------------------------
 
- [NOTE]
 
- To pause a download, press Ctrl-C.
 
- You can resume the transfer by running aria2c with the same argument at the same
 
- directory.
 
- Download several local metalink files
 
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
- ----------------------------------------
 
- aria2c -j2 file1.metalink file2.metalink
 
- ----------------------------------------
 
- Download only selected files using index
 
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
- -------------------------------------------
 
- aria2c --select-file=1-4,8 file.metalink
 
- -------------------------------------------
 
- [NOTE]
 
- The index is printed to the console using -S option.
 
- Download a file using a local .metalink file with user preference
 
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
- ------------------------------------------------------------------------------
 
- aria2c --metalink-location=JP,US --metalink-version=1.1 --metalink-language=en-US -C2 file.metalink
 
- ------------------------------------------------------------------------------
 
- BitTorrent Download
 
- ~~~~~~~~~~~~~~~~~~~
 
- Download files from remote BitTorrent file
 
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
- -------------------------------------------------------
 
- aria2c --follow-bittorrent=mem http://host/file.torrent
 
- -------------------------------------------------------
 
- Download using a local torrent file
 
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
- ---------------------------------------------
 
- aria2c --max-upload-limit=40K file.torrent
 
- ---------------------------------------------
 
- [NOTE]
 
- --max-upload-limit specifies the max of upload rate.
 
- [NOTE]
 
- To pause a download, press Ctrl-C. You can resume the transfer by run aria2c with the same argument at the same directory.
 
- Download 2 torrents
 
- ^^^^^^^^^^^^^^^^^^^
 
- --------------------------------------
 
- aria2c -j2 file1.torrent file2.torrent
 
- --------------------------------------
 
- Download a file using torrent and HTTP/FTP server
 
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
- -----------------------------------------------------------
 
- aria2c -Ttest.torrent http://host1/file ftp://host2/file
 
- -----------------------------------------------------------
 
- [NOTE]
 
- Downloading multi file torrent with HTTP/FTP is not supported.
 
- Download only selected files using index(usually called "selectable download")
 
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
- ---------------------------------------
 
- aria2c --select-file=1-4,8 file.torrent
 
- ---------------------------------------
 
- [NOTE]
 
- The index is printed to the console using -S option.
 
- Change the listening port for incoming peer
 
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
- ---------------------------------------------------
 
- aria2c --listen-port=7000-7001,8000 file.torrent
 
- ---------------------------------------------------
 
- [NOTE]
 
- Since aria2 doesn't configure firewall or router for port forwarding, it's up
 
- to you to do it manually.
 
- Specify the condition to stop program after torrent download finished
 
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
- -------------------------------------------------------
 
- aria2c --seed-time=120 --seed-ratio=1.0 file.torrent
 
- -------------------------------------------------------
 
- [NOTE]
 
- In the above example, the program exists when the 120 minutes has elapsed since download completed or seed ratio reaches 1.0.
 
- Throttle upload speed
 
- ^^^^^^^^^^^^^^^^^^^^^
 
- ----------------------------------------------
 
- aria2c --max-upload-limit=100K file.torrent
 
- ---------------------------------------------- 
 
- Enable DHT
 
- ^^^^^^^^^^
 
- ---------------------------------------------------------
 
- aria2c --enable-dht --dht-listen-port=6881 file.torrent
 
- ---------------------------------------------------------
 
- [NOTE]
 
- DHT uses udp port. Since aria2 doesn't configure firewall or router for port
 
- forwarding, it's up to you to do it manually.
 
- More advanced HTTP features
 
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
- Load cookies
 
- ^^^^^^^^^^^^
 
- ------------------------------------------------------
 
- aria2c --load-cookies=cookies.txt http://host/file.zip
 
- ------------------------------------------------------
 
- [NOTE]
 
- You can use Firefox/Mozilla's cookie file without modification.
 
- Resume download started by web browsers or another programs
 
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
- ---------------------------------------------------
 
- aria2c -c -s2 http://host/partiallydownloadedfile.zip 
 
- ---------------------------------------------------
 
- And more advanced features
 
- ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
- Throttle download speed
 
- ^^^^^^^^^^^^^^^^^^^^^^^
 
- -------------------------------------------------
 
- aria2c --max-download-limit=100K file.metalink
 
- -------------------------------------------------
 
- Repair a damaged download using --check-integrity option
 
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
- ----------------------------------------------
 
- aria2c --check-integrity=true file.metalink
 
- ----------------------------------------------
 
- [NOTE]
 
- This option is only available used with BitTorrent or metalink with chunk
 
- checksums.
 
- Drop connection if download speed is lower than specified value
 
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
- ------------------------------------------------
 
- aria2c --lowest-speed-limit=10K file.metalink
 
- ------------------------------------------------
 
- Parameterized URI support
 
- ^^^^^^^^^^^^^^^^^^^^^^^^^
 
- You can specify set of parts:
 
- ---------------------------------------------
 
- aria2c -P http://{host1,host2,host3}/file.iso
 
- ---------------------------------------------
 
- You can specify numeric sequence:
 
- -------------------------------------------
 
- aria2c -Z -P http://host/image[000-100].png
 
- -------------------------------------------
 
- [NOTE]
 
- -Z option is required if the all URIs don't point to the same file, such as the above example.
 
- You can specify step counter:
 
- -----------------------------------------
 
- aria2c -Z -P http://host/image[A-Z:2].png 
 
- -----------------------------------------
 
- Parallel downloads of arbitrary number of URL,metalink,torrent
 
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
- ------------------------------------------------------------
 
- aria2c -j3 -Z http://host/file1 file2.torrent file3.metalink
 
- ------------------------------------------------------------
 
- BitTorrent Encryption
 
- ^^^^^^^^^^^^^^^^^^^^^
 
- Encrypt whole payload using ARC4:
 
- -------------------------------------------------------------------------
 
- aria2c --bt-min-crypto-level=arc4 --bt-require-crypto=true file.torrent
 
- -------------------------------------------------------------------------
 
- RESUME DOWNLOAD
 
- ---------------
 
- Usually, you can resume transfer by just issuing same command(aria2c URL)
 
- if the previous transfer is made by aria2.
 
- If the previous transfer is made by a browser or wget like sequencial
 
- download manager, then use -c option to continue the transfer(aria2c -c URL).
 
- CONTROL FILE
 
- ------------
 
- aria2 uses a control file to keep track the progress of download.
 
- A control file is placed at the same directory of the dowloading file and
 
- its filename is the filename of downloading file with ".aria2" appended.
 
- For example, if you are downloading file.zip, then the control file should be
 
- file.zip.aria2.
 
- (There is a exception for this naming convention.
 
- If you are downloading a multi torrent, its control file is the "top directory"
 
- name of the torrent with ".aria2" appended.
 
- The "top directory" name is a value of "name" key in "info" directory in a torrent file.)
 
- Usually a control file is deleted once download completed.
 
- If aria2 decides that download cannot be resumed(for example, when downloading
 
- a file from a HTTP server which doesn't support resume), a control file is
 
- not created.
 
- Normally if you lose a control file, you cannot resume download.
 
- But if you have a torrent or metalink with chunk checksums for the file,
 
- you can resume the download without a control file by giving
 
- --check-integrity=true option to aria2c in command-line.
 
- SEEDING DOWNLOADED FILE IN BITTORRENT
 
- -------------------------------------
 
- You can seed downloaded file using --check-integrity=true option.
 
- ---------------------------------------------
 
- aria2c --check-integrity=true file.torrent
 
- ---------------------------------------------
 
- FILES
 
- -----
 
- aria2.conf
 
- ~~~~~~~~~~
 
- User configuration file.
 
- It must be placed under $HOME/.aria2 and must be named as aria2.conf.
 
- In each line, there is 1 parameter whose syntax is name=value pair,
 
- where name is the long command-line option name without '--' prefix.
 
- The lines beginning '#' are treated as comments.
 
- --------------------------------------
 
- # sample configuration file for aria2c
 
- listen-port=60000
 
- dht-listen-port=60000
 
- seed-ratio=1.0
 
- max-upload-limit=50K
 
- ftp-pasv=true
 
- --------------------------------------
 
- dht.dat
 
- ~~~~~~~~
 
- The routing table of DHT is saved to the path $HOME/.aria2/dht.dat.
 
- RESOURCES
 
- ---------
 
- Project web site: http://aria2.sourceforge.net/[]
 
- metalink: http://www.metalinker.org/[]
 
- REPORTING BUGS
 
- --------------
 
- Report bugs to Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
 
- AUTHOR
 
- ------
 
- Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
 
- COPYRIGHT
 
- ---------
 
- Copyright (C) 2006, 2008 Tatsuhiro Tsujikawa
 
- This program is free software; you can redistribute it and/or modify
 
- it under the terms of the GNU General Public License as published by
 
- the Free Software Foundation; either version 2 of the License, or
 
- (at your option) any later version.
 
- This program is distributed in the hope that it will be useful,
 
- but WITHOUT ANY WARRANTY; without even the implied warranty of
 
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 
- GNU General Public License for more details.
 
- You should have received a copy of the GNU General Public License
 
- along with this program; if not, write to the Free Software
 
- Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 
- In addition, as a special exception, the copyright holders give
 
- permission to link the code of portions of this program with the
 
- OpenSSL library under certain conditions as described in each
 
- individual source file, and distribute linked combinations
 
- including the two.
 
- You must obey the GNU General Public License in all respects
 
- for all of the code used other than OpenSSL.  If you modify
 
- file(s) with this exception, you may extend this exception to your
 
- version of the file(s), but you are not obligated to do so.  If you
 
- do not wish to do so, delete this exception statement from your
 
- version.  If you delete this exception statement from all source
 
- files in the program, then also delete it here.
 
 
  |