Provided by: aria2_1.19.0-1build1_amd64 
NAME
aria2c - Utilitário para download super ultra rápido
SINOPSE
aria2c [<OPÇÕES>] [<URI>|<MAGNET>|<ARQUIVO_TORRENT>|<ARQUIVO_METALINK>] ...
DESCRIÇÃO
AVISO:
This translation has been outdated quite sometime now, and lacks many recent changes.
Please consult English version manual for updated information.
Observação: Para executar o aria2 em um terminal ou no prompt da linha de comando do
windows, utilize o comando aria2c.
aria2 é um utilitário para download de arquivos. Os protocolos suportados são HTTP, HTTPS,
FTP, BitTorrent e Metalink. aria2 pode efetuar download de arquivos a partir de múltiplas
fontes e protocolos e tenta utilizar a máxima capacidade de banda. Há suporte para
download de arquivos que tem origem em HTTP, HTTPS, FTP, BitTorrent e Metalink ao mesmo
tempo, enquanto os dados baixados podem ser (uploaded) e compartilhados pelo BitTorrent.
Usando conferência / aferição (checksum) nos Metalinks, aria2 automaticamente valida o
conteúdo dos dados enquanto faz o download do arquivo como BitTorrent.
OPÇÕES BÁSICAS DO ARIA2
Opções Comuns
-d, --dir=<DIR>
O diretório onde será armazenado o arquivo baixado.
-i, --input-file=<ARQUIVO>
Executa download da(s) URI encontradas no ARQUIVO. Podem ser especificados
múltiplos URI para uma simples entidade: separe URI na mesma linha com um caracter
TAB (tabulação). Quando desejar ler a entrada padrão (stdin) especificar -
(hífen). Adicionalmente, diversas opções podem ser especificadas após cada linha
de URI. Esta(s) linha(s) opcional(is) deve(m) começar(em) com um ou mais espaços
em branco e possuir(em) apenas uma opção por linha. Ver subseção Arquivo de
Entrada para mais detalhes. Ver também opção --deferred-input.
-l, --log=<LOG>
O nome do arquivo de log. Se - for especificado (entrada padrão), log é gravado em
stdout (saída padrão). Se uma string vazia("") é especificada, log não será gravado
em arquivo.
-j, --max-concurrent-downloads=<N>
Configura o número máximo de downloads paralelos para cada URI (HTTP, HTTPS, FTP),
Torrent e Metalink. Ver também opção --split. Padrão: 5
-V, --check-integrity[=true|false]
Verifica a integridade do arquivo validando pedaços hashes ou um hash do arquivo
inteiro. Essa opção tem efeito só em downloads BitTorrent, Metalink com checksums
ou HTTP, HTTPS e FTP com a opção --checksum. Se pedaços de hashes são providos,
essa opção pode detectar porções danificadas de um arquivo e efetuar novamente o
download desses pedaços. Se especificar hash do arquivo inteiro, a verificação do
hash ocorrerá só ao final do download, validação que leva em conta o tamanho do
arquivo, e o download reinicirá a partir do início. Se houver especificação de
ambos métodos de hash será utilizado o hash de pedações. Padrão: false
-c, --continue[=true|false]
Continua o download a partir de um download parcial, anteriormente interrompido.
Use esta opção para retormar um download iniciado a partir de um browser
(navegador) ou outro programa que faz baixa de arquivos sequencialmente desde o
início. Atualmente esta opção só é aplicavel a download de HTTP, HTTPS e FTP.
-h, --help[=<TÓPICO>|<PALAVRA-CHAVE>]
As mensagens de Ajuda são classificadas em temas. Um tema se inicia com #. Por
exemplo, digitar --help=#http para obter a explicação do uso das opções do tema
#http. Se digitar um termo que não é tema, haverá exibição das opções que incluem o
termo informado. Valores disponíveis para temas podem ser: #basic, #advanced,
#http, #https, #ftp, #metalink, #bittorrent, #cookie, #hook, #file, #rpc,
#checksum, #experimental, #deprecated, #help, #all Padrão: #basic
Opções HTTP / FTP
--all-proxy=<PROXY>
Usar este servidor proxy para todos protocolos. Para limpar proxy previamente
definido, use "". Esta configuração pode ser sobreposta através da especificação
de um servidor proxy para um determinado protocolo usando opções --http-proxy,
--https-proxy e --ftp-proxy. Isto afeta todas as URIs. O formato da opção PROXY é
[http://][USUÁRIO:SENHA@]SERVIDOR[:PORTA]. Ver também seção VARIÁVEIS DE AMBIENTE
section.
NOTA:
Se usuário e senha são embutidos na URI do proxy eles também podem ser
especificados através das opções --{http,https,ftp,all}-proxy-{usuário,senha},
aqueles que aparecerem por último assumem a precedência. Por exemplo, quando
temos: http-proxy-user=meunome, http-proxy-passwd=minhasenha em aria2.conf e
especificamos --http-proxy="http://svrproxy" na linha de comando, então obtemos
como proxy HTTP http://svrproxy com o usuário meunome e senha minhasenha.
Outro exemplo: quando especificamos na linha de comando:
--http-proxy="http://usuário:senha@svrproxy" --http-proxy-user="meunome"
--http-proxy-passwd="minhasenha", então obtemos proxy HTTP http://svrproxy com
usuário meunome e senha minhasenha.
Mais um exemplo: se especificamos na linha de comando:
--http-proxy-user="meunome" --http-proxy-passwd="minhasenha"
--http-proxy="http://utilizador:acesso@svrproxy", então obtemos o proxy HTTP
http://svrproxy com o usuário utilizador e a senha acesso.
--all-proxy-passwd=<SENHA>
Define senha para a opção --all-proxy.
--all-proxy-user=<USUÁRIO>
Define usuário para opção --all-proxy.
--checksum=<TIPO>=<ALGORITMO>
Define verificação (checksum). TIPO é o tipo de algoritmo(hash). Os tipos de
algoritmos estão listados em Algoritmos de Hash e podem ser obtidos através do do
comando aria2c -v. DIGEST é o código hexadecimal. Por examplo, definindo sha-1 o
resultado parece com: sha-1=0192ba11326fe2298c8cb4de616f4d4140213838 Essa opção
aplica-se apenas para downloads HTTP, HTTPS e FTP.
--connect-timeout=<SEGUNDOS>
Define o tempo de espera em segundos para estabelecer a conexão com o servidor
proxy. Após o estabelecimento da conexão, esta opção não tem mais efeito, mas a
opção --timeout será utilizada. Padrão: 60
--dry-run[=true|false]
Se true é informado, aria2 apenas verifica se o arquivo remoto está disponível para
download dos dados. Esta opção tem efeito em downloads de servidores HTTP, HTTPS e
FTP. Downloads de BitTorrent serão cancelados se for especificado true. Padrão:
false
--lowest-speed-limit=<VELOCIDADE>
Fecha a conexão se a velocidade de download é menor ou igual ao valor especificado,
bytes por segundo. 0 significa que aria2 não levará em conta limite de velocidade
mínima. Pode ser anexado K ou M (1K = 1024, 1M = 1024K). Esta opção não abrange
downloads do tipo BitTorrent. Padrão: 0
-x, --max-connection-per-server=<NÚMERO>
O número máximo de conexões para um servidor em cada download. Padrão: 1
--max-file-not-found=<NÚMERO>
Se aria2 recebe çódigo de retorno "arquivo não encontrado" de um servidor remoto de
HTTP / FTP um NÚMERO de vezes sem obter nenhum byte, então o download é forçado a
falhar. Especificar 0 para desabilitar esta opção. Esta opção só é válida para
servidores HTTP / FTP. Padrão: 0
-m, --max-tries=<NÚMERO>
Define o número de tentativas. 0 significa ilimitadas. See also --retry-wait.
Padrão: 5
-k, --min-split-size=<TAMANHO>
aria2 não divide menos que 2 * TAMANHO o intervalo de bytes. Por exemplo,
considere download de um arquivo de 20MiB. Se o TAMANHO é 10M, aria2 pode dividir o
arquivo em 2 intervalos de [0-10MiB) e [10MiB-20MiB) e executar o download usando 2
fontes (logicamente se a opção --split >= 2). Se o TAMANHO é 15M, desde que 2 *
15M > 20Mib, aria2 não dividirá o arquivo e fará o download de 1 fonte. Pde ser
anexado K ou M (1K = 1024, 1M = 1024K). Valores Possíveis: 1M -1024M Padrão: 20M
-n, --no-netrc[=true|false]
Desabilita suporte netrc. Padrão: Suporte a netrc é habilitado por padrão.
NOTA:
arquivo netrc é lido somente no início se a opção --no-netrc é false. Portanto
se a opção --no-netrc é true no início, não haverá netrc disponível durante toda
a sessão, mesmo que seja utilizada a opção aria2.changeGlobalOption() para
executar a opção :option: --no-netrc=false <-n>.
--no-proxy=<DOMÍNIOS>
Especifica nomes de servidores, domínios e endereços de redes com ou sem blocos
CIDR para os quais não serão utilizados proxy.
NOTA:
Para endereço de rede com blocos CIDR, ambos endereços IPv4 ou IPv6 funcionam.
Implementação atual, não resolve nome host em URI para comparar com endereço
especificado na opção --no-proxy. Portanto só será efetiva se a URI possuir
números de endereço IP.
-o, --out=<ARQUIVO>
O nome do arquivo baixado. Quando a opção --force-sequential é utilizada esta opção
será ignorada.
NOTA:
Em um download Metalink ou BitTorrent não poderá ser especificado o nome do
arquivo. O nome do arquivo especificado aqui é usado quando através da linha de
comando é informada para o aria2 sem a utilização da opção --input-file,
--force-sequential. Por exemplo:
$ aria2c -o meuarquivo.zip "http://server1/arquivo.zip" "http://server2/arquivo.zip"
--proxy-method=<MÉTODO>
Define o método utilizado para requisições de proxy. MÉTODO é get ou tunnel.
Downloads HTTPS sempre utiliza tunnel, independentemente desta opção. Padrão: get
-R, --remote-time[=true|false]
Recuperar timestamp do arquivo remoto a partir do servidor remoto HTTP / FTP e se
disponível, aplicá-lo ao arquivo local. Padrão: false
--reuse-uri[=true|false]
Reutilizar uma URI já utilizada. Se não habilitada as URIs já utilizadas serão
abandonadas. Padrão: true
--retry-wait=<SEGUNDOS>
Define quantos segundos haverá entre as tentativas. Com SEGUNDOS > 0, aria2 irá
tentará fazer o download quando o servidor HTTP retornar código resposta 503.
Padrão: 0
--server-stat-of=<ARQUIVO>
Define o nome do arquivo no qual será salvo o perfil de performance de um ou mais
servidores acessados. Para carregar dados já salvos utilizar opção
--server-stat-if. Ver subseção Perfil Performance Servidor abaixo, para o formato
do arquivo.
--server-stat-if=<ARQUIVO>
Specify the filename to load performance profile of the servers. The loaded data
will be used in some URI selector such as feedback. See also --uri-selector
option. See Perfil Performance Servidor subsection below for file format.
--server-stat-timeout=<SEGUNDOS>
Specifies timeout in seconds to invalidate performance profile of the servers since
the last contact to them. Padrão: 86400 (24hours)
-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. Padrão: 5
NOTA:
Some Metalinks regulate the number of servers to connect. aria2 strictly
respects them. This means that if Metalink defines the maxconnections attribute
lower than N, then aria2 uses the value of maxconnections attribute instead of
N.
--stream-piece-selector=<SELECTOR>
Specify piece selection algorithm used in HTTP e FTP download. Piece means fixed
length segment which is downloaded in parallel in segmented download. If default is
given, aria2 selects piece so that it reduces the number of establishing
connection. This is reasonable default behaviour because establishing connection is
an expensive operation. If inorder is given, aria2 selects piece which has minimum
index. Index=0 means first of the file. This will be useful to view movie while
downloading it. --enable-http-pipelining option may be useful to reduce
reconnection overhead. Please note that aria2 honors --min-split-size option, so
it will be necessary to specify a reasonable value to --min-split-size option. If
geom is given, at the beginning aria2 selects piece which has minimum index like
inorder, but it exponentially increasingly keeps space from previously selected
piece. This will reduce the number of establishing connection and at the same time
it will download the beginning part of the file first. This will be useful to view
movie while downloading it. Padrão: default
-t, --timeout=<SEGUNDOS>
Set timeout in seconds. Padrão: 60
--uri-selector=<SELECTOR>
Specify URI selection algorithm. The possible values are inorder, feedback and
adaptive. If inorder is given, URI is tried in the order appeared in the URI list.
If feedback is given, aria2 uses download speed observed in the previous downloads
and choose fastest server in the URI list. This also effectively skips dead
mirrors. The observed download speed is a part of performance profile of servers
mentioned in --server-stat-of and --server-stat-if options. If adaptive is given,
selects one of the best mirrors for the first and reserved connections. For
supplementary ones, it returns mirrors which has not been tested yet, and if each
of them has already been tested, returns mirrors which has to be tested again.
Otherwise, it doesn't select anymore mirrors. Like feedback, it uses a performance
profile of servers. Padrão: feedback
Opções Específicas de HTTP e HTTPS
--ca-certificate=<ARQUIVO>
Utilizar o certificado do ARQUIVO FILE para verificar os Servidores. O certificado
precisa estar no formato PEM e pode conter múltiplos certificados CA.
Utilizar a opção --check-certificate para habilitar a verificação.
NOTA:
Se aria2 foi compilado com OpenSSL ou versão mais recente de GnuTLS a qual tem a
função gnutls_certificate_set_x509_system_trust() e a biblioteca foi
adequadamente configurada para localizar o certificado CA existente, aria2 irá
carregar automaticamente estes certificados no início.
--certificate=<ARQUIVO>
Usar arquivo com certificado cliente. O certificado deve estar no formato PEM.
Pode ser usada a opção --private-key para especificar uma chave particular.
--check-certificate[=true|false]
Verifica se o peer esta usando o certificado especificado na opção
--ca-certificate. Padrão: true
--http-accept-gzip[=true|false]
Envia cabeçalho requisição Accept: deflate, gzip e faz (inflate) se o servidor
remoto responder com Content-Encoding: gzip ou Content-Encoding: deflate. Padrão:
false
NOTA:
Alguns servidores respondem com Content-Encoding: gzip para arquivos que são
gzip. aria2 faz inflate destes por causa do cabeçalho de resposta.
--http-auth-challenge[=true|false]
Envia cabeçalho de autorização HTTP só quando requisitado pelo servidor. Se false
é habilitado, então o cabeçalho de autorização sempre será enviado ao servidor. Há
uma exceção: se o nome do usuário de senha são embutidas na URI, o cabeçalho de
autorização sempre será enviado ao servidor independente desta opção. Padrão:
false
--http-no-cache[=true|false]
Envia Cache-Control: no-cache e Pragma: cabeçalho no-cache para evitar conteúdo do
cache. Se false é fornecido, esses cabeçalhos não serão enviados e poderá ser
adicionado o cabeçalho de Cache-Control com a diretiva desejada usando a opção
--header. Padrão: true
--http-user=<USUÁRIO>
Define usuário HTTP. Isto afeta todas as URIs.
--http-passwd=<PASSWD>
Define senha HTTP. Isto afeta todas as URIs.
--http-proxy=<PROXY>
Usar este servidor proxy para HTTP. Para limpar o proxy anteriormente definido use
"". Ver também opção --all-proxy. Isto afeta todas URIs. O formato de PROXY é
[http://][USUÁRIO:SENHA@]SERVIDOR[:PORTA]
--http-proxy-passwd=<SENHA>
Define a senha para opção --http-proxy.
--http-proxy-user=<USUÁRIO>
Define o usuário para a opção --http-proxy.
--https-proxy=<PROXY>
Usar este servidor proxy para HTTPS. Para limpar o proxy anteriormente, use "".
Ver também opção --all-proxy. Isto afeta todas URIs. O formato de PROXY é
[https://][USUÁRIO:SENHA@]SERVIDOR[:PORTA]
--https-proxy-passwd=<SENHA>
Define senha para a opção --https-proxy.
--https-proxy-user=<USUÁRIO>
Define usuário para a opção --https-proxy.
--private-key=<ARQUIVO>
Define o arquivo de chave particular que será usado. A chave particular deve estar
no formato PEM e não pode estar criptografada. O comportamento quando estiver
criptografada é indefinido. Ver também a opção --certificate.
--referer=<REFERER>
Define a referência. Afeta todas URIs. Se * é usado, cada URI requisitada é usada
como referência (referer). Pode ser útil quando usado em conjunto com a opção
--parameterized-uri.
--enable-http-keep-alive[=true|false]
Enable HTTP/1.1 persistent connection. Padrão: true
--enable-http-pipelining[=true|false]
Habilita pipelining para HTTP/1.1. Padrão: false
NOTA:
Da perspectiva de performance, não há vantagem em habilitar esta opção.
--header=<HEADER>
Anexa CABEÇALHOao ao cabeçalho HTTP requisitado. Pode usar esta opção várias vezes
para especificar múltiplos cabeçalhos:
$ aria2c --header="X-A: b78" --header="X-B: 9J1" "http://servidor/arquivo"
--load-cookies=<ARQUIVO>
Carregar Cookies do ARQUIVO usando formato Firefox3 format (SQLite3), Chromium /
Google Chrome (SQLite3) e formato Mozilla / Firefox(1.x/2.x) / Netscape.
NOTA:
Se aria2 é compilado sem libsqlite3, então não havera suporte aos formatos de
cookie Firefox3 e Chromium / Google Chrome.
--save-cookies=<ARQUIVO>
Salva Cookies para o ARQUIVO no formato Mozilla / Firefox(1.x/2.x) / Netscape. Se
ARQUIVO já existe, será sobreposto. Cookies da Sessão também serão salvos e seus
valores de expiração serão tratados como 0. Valores Possíveis: /caminho/do/arquivo
--use-head[=true|false]
Usar método HEAD para a primeira requisição ao servidor HTTP. Padrão: false
-U, --user-agent=<AGENTE_USUÁRIO>
Define usuário agente para download HTTP, HTTPS. Padrão: aria2/$VERSION, $VERSION
é substituída pela versão do aria2.
Opções Específicas de FTP
--ftp-user=<USUÁRIO>
Definir o usuário FTP. Isto afeta todas as URIs. Padrão: anonymous
--ftp-passwd=<SENHA_FTP>
Definir senha FTP. Isto afeta todas as URIs. Se o nome existe, mas a senha esta
ausente, para login em uma URI, aria2 tenta obter a senha usando o arquivo .netrc,
caso exista senha declarada no .netrc. Se não existir será utilizada a senha
declarada nesta opção. Padrão: ARIA2USER@
-p, --ftp-pasv[=true|false]
Usar modo passivo no FTP. Se false é informado, o modo ativo será usado. Padrão:
true
--ftp-proxy=<PROXY>
Usar este servidor proxy para FTP. Para limpar definição proxy previamente
definido, use "". Ver também opção --all-proxy. Isto afeta todas URIs. O formato
do PROXY é [http://][USUÁRIO:SENHA@]SERVIDOR[:PORTA]
--ftp-proxy-passwd=<PASSWD>
Define senha para a opção --ftp-proxy.
--ftp-proxy-user=<USUÁRIO>
Define senha para opção --ftp-proxy.
--ftp-type=<TYPE>
Define tipo de transferência FTP. Que pode ser: binary ou ascii. Padrão: binary
--ftp-reuse-connection[=true|false]
Reutilizar conexão FTP. Padrão: true
Opções Comuns de BitTorrent / Metalink
--select-file=<INDEX>...
Define arquivo para download através da especificação de seu index. Para achar o
index do arquivo use a opção --show-files. Múltiplos indíces podem ser
especificados usando-se ,, por exemplo: 3,6. Também pode ser usado - para
especificar intervalos: 1-5. Ambos podem ser usados juntos , e - exemplo: 1-5,8,9.
Quando usados com a opção -M, o índice pode variar dependendo das opções da query.
Ver opções (--metalink-*).
NOTA:
Em torrent de múltiplos arquivos, os arquivos adjacentes especificados por essa
opção também podem ser baixados. Esse é o comportamento esperado não é um
bug/erro. Um simples pedaço pode incluir diversos arquivos ou partes de
arquivos, e aria2 grava o pedaço(s) no(s) arquivo(s) apropriado(s).
-S, --show-files[=true|false]
Imprimir a lista de arquivos do ".torrent", ".meta4" e ".metalink" e termina. No
caso de arquivo ".torrent", informações adicionais são impressas. (infohash,
tamanho pedaço, etc).
Opções Específicas de BitTorrent
--bt-enable-lpd[=true|false]
Habilita Descobrir Peer Local. Se indicador particular é configurado no torrent,
aria2 não usa esta funcionalidade mesmo que true foi informato. Padrão: false
--bt-exclude-tracker=<URI>[,...]
Lista separada por vírgulas, de trackers de URI BitTorrent que devem ser removidas.
Pode ser usado o valor especial * para especificar todas URIs; isso irá excluir
todas URIs de "announce". Quando especificar * em uma linha de comando do shell,
lembre-se de forçar o escape or delimite com aspas, apóstrofo ou em linux com crase
caracter . Ver também opção :option: `--bt-tracker.
--bt-external-ip=<ENDEREÇO-IP>
Especificar o IP externo para reportar um track BitTorrent. Mesmo que esta função
tenha o nome external, ela pode aceitar qualquer tipo de endereço IP. ENDEREÇO-IP
deve ser um endereço IP numérico.
--bt-hash-check-seed[=true|false]
Se true é informado, após o check do hash usando a opção :option: --check-integrity
<-V> e o arquivo esta completo, continue o arquivo seed. Se desejar verificar o
arquivo e efetuar o download somente quando ele estiver imcompleto ou danificado,
defina esta opção para false. Esta opção só tem efeito para download de
BitTorrent. Padrão: true
--bt-lpd-interface=<INTERFACE>
Use o interface de rede informado para Descobrir o Peer Local. Se esta opção não é
especificada, o interface padrão é usado. Pode ser especificado o nome do interface
e o endereço IP. Valores possíveis: interface, endereço IP
--bt-max-open-files=<NÚMERO>
Especificar o número máximo de arquivos para abrir para cada download BitTorrent.
Padrão: 100
--bt-max-peers=<NÚMERO>
Especificar o número máximo de peers para cada torrent. 0 significa ilimitado.
Ver também a opção :option: --bt-request-peer-speed-limit. Padrão: 55
--bt-metadata-only[=true|false]
Download somente os metadados. O(s) arquivo(s) descrito(s) no(s) metadado(s) não
será(ão) baixado(s). Esta opção só tem efeito para URI BitTorrent Magnet. Ver
também a opção :option: --bt-save-metadata. Padrão: false
--bt-min-crypto-level=plain|arc4
Define o nível mínimo do método de critografia. Se existem diversos métodos são
fornecidos por um peer, aria2 escolhe o que satisfaz o menor nível especificado.
Padrão: plain
--bt-prioritize-piece=head[=<TAMANHO>],tail[=<TAMANHO>]
Tentar primeiramente o download do primeiro e último pedaço de cada arquivo Isto é
útil para ver antecipadamente os arquivos. O argumento pode conter duas palavras
chave: head e tail. Para incluir ambos, devem estar separados por vírgula. Estas
palavras chave possuem um parâmetro tamanho. Por examplo, se head=<TAMANHO> é
especificado, pedaço no intervalo do número de bytes iniciais de cada arquivo terão
prioridade. tail=<TAMANHO> significa que o intervalo final no TAMANHO informado
de cada arquivo. TAMANHO pode incluir K ou M (1K = 1024, 1M = 1024K). Se TAMANHO é
omitido, TAMNHA de 1M será usado.
--bt-remove-unselected-file[=true|false]
Remove os arquivos não selecionados quando o download do BitTorrent estiver
completo. Para selecionar arquivo(s) use a opção --select-file. Se não for usada
esta opção, é assumido que todos os arquivos serão selecionados. Use esta opção com
critério pois ela realmente remove arquivo(s) do seu disco. Padrão: false
--bt-require-crypto[=true|false]
Se true é informado, aria2 não aceita nem estabelece conexão com handshake de
BitTorrent (protocolo 19BitTorrent). Em vez disso aria2 usa (Obfuscation handshake.
Padrão: false
--bt-request-peer-speed-limit=<VELOCIDADE>
Se a velocidade total de download do torrent é menor que a <VELOCIDADE>, aria2
temporariamente incrementa o número de peers para tentar maior velocidade de
download. Configurando esta opção com sua velocidade preferida pode incrementar a
velocidade de download em alguns casos. Pode ser anexado K ou M (1K = 1024, 1M =
1024K). Padrão: 50K
--bt-save-metadata[=true|false]
Salvar metadados como arquivo ".torrent" file. Esta opção tem efeito somente se URI
usada é de BitTorrent Magnet. O nome do arquivo é codificado em hash em
hexadecimal com sufixo de ".torrent". O diretório onde será salvo o o metadado, é o
mesmo onde aponta o download do arquivo. Se o arquivo já existe, o metadado não
será salvo. Ver tambémn a opção :option: --bt-metadata-only. Padrão: false
--bt-seed-unverified[=true|false]
Faz Seed do arquivo previamente baixado sem verificar os hashes dos pedaços.
Padrão: false
--bt-stop-timeout=<SEGUNDOS>
Interrompe o download do BitTorrent se a velocidade do for zero por consecutivos
SEGUNDOS. Se 0 é informado, esta funcionalidade é desabilitada. Padrão: 0
--bt-tracker=<URI>[,...]
Lista URI, separada por vírgulas, dos rastreadores BitTorrent. Estas URIs não são
afetadas pela opção --bt-exclude-tracker, porque elas são adicionadas após as URIs
da opção --bt-exclude-tracker serem removidas.
--bt-tracker-connect-timeout=<SEGUNDOS>
Define o tempo de conexão em segundos para estabelecera conexão com o tracker.
Após a conexão ser estabelecida, esta opção não tem mais efeito e a opção
--bt-tracker-timeout é usada. Padrão: 60
--bt-tracker-interval=<SEGUNDOS>
Define o intervalo em segundos, entre as requisições ao tracker / rastreador. Isso
sobrepõe o valor do intervalo e aria2 passa a usá-los e ignorar o valor mínimo de
resposta do tracker / rastreador. Se 0 é definido, aria2 assume que o intervalo
será baseado no tracker / rastreador e o download irá prosseguir. Padrão: 0
--bt-tracker-timeout=<SEGUNDOS>
Define em segundos o intervalo do timeout. Padrão: 60
--dht-entry-point=<SERVIDOR>:<PORTA>
Define servidor e a porta da rede DHT IPv4.
--dht-entry-point6=<SERVIDOR>:<PORTA>
Define servidor e a porta da rede DHT IPv6.
--dht-file-path=<CAMINHO>
Modifica o caminho (CAMINHO) para o arquivo da tabela de roteamento DHT IPv4.
Padrão: $HOME/.aria2/dht.dat
--dht-file-path6=<PATH>
Modifica o caminho (CAMINHO) para o arquivo da tabela de roteamento DHT IPv6.
Padrão: $HOME/.aria2/dht6.dat
--dht-listen-addr6=<ADDR>
Define o endereço para o bind do socket para DHT IPv6. Deve ser endereço global
IPv6 do servidor.
--dht-listen-port=<PORT>...
Define portas UDP para ouvir para DHT (IPv4 e IPv6) e rastreador UDP. Múltiplas
portas podem ser especificadas através do uso de ,, por exemplo: 6881,6885. Também
pode ser usado - para especificar intervalo, exemplo: 6881-6999. Ambos , and -
podem ser usados em conjunto. Padrão: 6881-6999
NOTA:
Cerfifique-se que as portas especificadas estão disponíveis para tráfego UDP de
entrada.
--dht-message-timeout=<SEGUNDOS>
Define timeout em segundos. Padrão: 10
--enable-dht[=true|false]
Habilita funcionalidade DHT IPv4. Tambem habilita suporte a rastreador UDP. Se um
identificador particular é usado em um torrente, aria2 não usa DHT para aquele
download, mesmo que true foi informado. Padrão: true
--enable-dht6[=true|false]
Habilita funcionalidade DHT IPv6. Se identificador particular é usado em um
torrent, aria2 não usa DHT para aquele download mesmo que true foi informado. Usar
opção --dht-listen-port para especificar número(s) de porta(s) para ser(em)
ouvida(s). Ver também opção :option:` --dht-listen-addr6` Padrão: true
--enable-peer-exchange[=true|false]
Habilita extensão Peer Exchange. Se um indicador particular é usado nesse torrent,
essa funcionalidade será desabilitada para o download, mesmo que true foi
informado. Padrão: true
--follow-torrent=true|false|mem
Se true ou mem é especificado, quando um arquivo cujo sufixo é .torrent ou o tipo
de conteúdo é application/x-bittorrent é baixado, aria2 faz o parse como arquivo
torrent e executa o download dos arquivos mencionados nele. Se mem é especificado,
o arquivo torrent não será gravado em disco, apenas será mantido em memória. Se
false é especificado, a ação acima descrita não será executada. Padrão: true
-O, --index-out=<INDEX>=<PATH>
Define o caminho do arquivo com índice=INDEX. O arquivo índice pode ser localizado
usando-se a opção --show-files. PATH é o caminho relativo ao caminho especificado
na opção --dir. Esta opção pode ser usada múltiplas vezes. Com esta opção pode-se
especificar o nome dos arquivos que serão baixados pelo BitTorrent.
--listen-port=<PORT>...
Define o número das portas TCP para download de BitTorrent. Multiplas portas são
especificadas usando ,, por exemplo: 6881,6885. Também pode usar - para
especificar intervalos: 6881-6999. Ambos , and - podem ser usados em conjunto:
6881-6889,6999. Padrão: 6881-6999
NOTA:
Certifique-se que as portas estejam habilitadas para tráfego TCP de entrada.
--max-overall-upload-limit=<VELOCIDADE>
Define a velocidade máxima geral de upload em bytes/seg. 0 significa irrestrito.
Pode anexar K ou M (1K = 1024, 1M = 1024K). Para limitar a velocidade de upload
por torrent, usar opção --max-upload-limit. Padrão: 0
-u, --max-upload-limit=<VELOCIDADE>
Define a velocidade máxima para cada torrent em bytes/seg. 0 significa irrestrito.
Pode anexar K ou M (1K = 1024, 1M = 1024K). Para limitar a velocidade global de
upload de torrent, usar opção --max-overall-upload-limit. Padrão: 0
--peer-id-prefix=<PEER_ID_PREFIX>
Especifica o prefixo para ID do peer. O ID do peer em um BitTorrent tem o tamanho
de 20 bytes. Se mais de 20 bytes são especificados, somente os 20 bytes iniciais
serão usados. Se menos de 20 bytes são especificados, dados randomicos serão
adicionados para completar o tamanho de 20 bytes. Padrão: aria2/$VERSÃO-, $VERSÃO
é a versão do pacote aria2.
--seed-ratio=<RATIO>
Specify share ratio. Seed completed torrents until share ratio reaches RATIO. You
are strongly encouraged 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. Padrão: 1.0
--seed-time=<MINUTES>
Especificar o tempo de (seeding) em minutos. Ver também a opção --seed-ratio.
NOTA:
Especificando --seed-time=0 desabilita o (seeding) após o download ter sido
completado.
-T, --torrent-file=<TORRENT_FILE>
O caminho para o arquivo ".torrent". Não é obrigatório usar esta opção pois pode
ser especificado arquivo ".torrent" sem a opção --torrent-file.
Opções Específicas de Metalink
--follow-metalink=true|false|mem
If true or mem is specified, when a file whose suffix is .meta4 or .metalink or
content type of application/metalink4+xml or 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.
Padrão: true
--metalink-base-uri=<URI>
Specify base URI to resolve relative URI in metalink:url and metalink:metaurl
element in a metalink file stored in local disk. If URI points to a directory, URI
must end with /.
-M, --metalink-file=<METALINK_FILE>
The file path to ".meta4" and ".metalink" file. Reads input from stdin when - is
specified. You are not required to use this option because you can specify
".metalink" files without --metalink-file.
--metalink-language=<LANGUAGE>
The language of the file to download.
--metalink-location=<LOCATION>[,...]
The location of the preferred server. A comma-delimited 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.
Specify none to disable this feature. Padrão: 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. Padrão: true
Opções específicas de RPC
--enable-rpc[=true|false]
Enable JSON-RPC/XML-RPC server. It is strongly recommended to set username and
password using --rpc-user and --rpc-passwd option. See also --rpc-listen-port
option. Padrão: false
--pause[=true|false]
Pause o download após adicionado. Está opção só é efetiva quando a opção
--enable-rpc=true é informada. Padrão: false
--rpc-allow-origin-all[=true|false]
Adiciona o campo de cabeçalho, Access-Control-Allow-Origin, com o valor * á
resposta RPC. Padrão: false
--rpc-certificate=<ARQUIVO>
Usar o certificado no ARQUIVO para servidor RPC. O certificado deve estar no
formato PEM. Usar opção --rpc-private-key para especificar chave particular. Usar
a opção --rpc-secure para habilitar criptografia. Usuários de AppleTLS precisam
antes gerar o certificado próprio auto-assinado através do utilitário Keychain
Access, por ex: usando o assistente e tomando nota da identificação SHA-1 do
certificado gerado. Para executar o aria2c com a opção --rpc-secure usar
--rpc-certificate=<SHA-1> e apenas omitir a opção --rpc-private-key
--rpc-listen-all[=true|false]
Listen incoming JSON-RPC/XML-RPC requests on all network interfaces. If false is
given, listen only on local loopback interface. Padrão: false
--rpc-listen-port=<PORT>
Specify a port number for JSON-RPC/XML-RPC server to listen to. Possible Values:
1024 -65535 Padrão: 6800
--rpc-max-request-size=<TAMANHO>
Set max size of JSON-RPC/XML-RPC request. If aria2 detects the request is more than
SIZE bytes, it drops connection. Padrão: 2M
--rpc-passwd=<PASSWD>
Set JSON-RPC/XML-RPC password.
--rpc-private-key=<FILE>
Use the private key in FILE for RPC server. The private key must be decrypted and
in PEM format. Use --rpc-secure option to enable encryption. See also
--rpc-certificate option.
--rpc-save-upload-metadata[=true|false]
Save the uploaded torrent or metalink metadata in the directory specified by --dir
option. The filename consists of SHA-1 hash hex string of metadata plus extension.
For torrent, the extension is '.torrent'. For metalink, it is '.meta4'. If false
is given to this option, the downloads added by aria2.addTorrent() or
aria2.addMetalink() will not be saved by --save-session option. Default: false
--rpc-secure[=true|false]
RPC transport will be encrypted by SSL/TLS. The RPC clients must use https scheme
to access the server. For WebSocket client, use wss scheme. Use --rpc-certificate
and --rpc-private-key options to specify the server certificate and private key.
--rpc-user=<USUÁRIO>
Set JSON-RPC/XML-RPC user.
Opções Avançadas
--allow-overwrite[=true|false]
Reiniciar o download desde o início se o correspondente arquivo de controle não
existir. Ver também a opção --auto-file-renaming. Padrão: false
--allow-piece-length-change[=true|false]
Se false é informado, aria2 interrompe o download quando o tamanho de um pedaço for
diferente do especificado no arquivo controle. Se true é informado, o download
prossegue mas o progresso será perdido. Padrão: false
--always-resume[=true|false]
Sempre continuar. Se If true é informado, aria2 sempre tentará retomar o download
do ponto interrompido e se não for possivel o download será interrompido. Se false
é informado, quando todas URIs fornecidas não suportarem a continuidade do download
ou aria2 encontrar N URIs as quais não suportem retomar o download (N é o valor
especificado na opção --max-resume-failure-tries), aria2 irá iniciar o download do
início. Ver opção --max-resume-failure-tries Padrão: true
--async-dns[=true|false]
Habilita DNS assíncrono. Padrão: true
--async-dns-server=<ENDEREÇO-IP>[,...]
Lista separada por vírgulas, dos endereços dos servidores DNS assíncronos usados
pelo resolvedor. Normalmente o resolvedor de DNS assíncronos faz a leitura dos
endereços a partir do arquivo /etc/resolv.conf. Quando essa opção é usada é feito
uso dos servidores DNS especificados na opção em detrimento do conteúdo do arquivo
/etc/resolv.conf. Podem ser usados ambos endereços IPv4 e IPv6. Essa opção é útil
quando o sistema não possui /etc/resolv.conf e o usuário não tem permissão para
criá-lo.
--auto-file-renaming[=true|false]
Renomear o arquivo se o mesmo já existir. Essa opção só funciona em download HTTP,
HTTPS e FTP. O novo nome do arquivo terá um ponto e uma sequência (1..9999) como
sufixo. Padrão: true
--auto-save-interval=<SEGUNDOS>
Salvar o arquivo de controle (*.aria2) a cada intervalo de SEGUNDOS. Se 0 é
informado, o arquivo de controle não será salvo durante o download. aria2 salva o
arquivo de controle quando parar, independentemente do valor. As possibilidades vão
desde 0 até 600. Padrão: 60
--conditional-get[=true|false]
Download file only when the local file is older than remote file. This function
only works with HTTP, HTTPS, downloads only. It does not work if file size is
specified in Metalink. It also ignores Content-Disposition header. If a control
file exists, this option will be ignored. This function uses If-Modified-Since
header to get only newer file conditionally. When getting modification time of
local file, it uses user supplied filename(see --out option) or filename part in
URI if --out is not specified. To overwrite existing file, --allow-overwrite is
required. Padrão: false
--conf-path=<PATH>
Change the configuration file path to PATH. Padrão: $HOME/.aria2/aria2.conf
--console-log-level=<LEVEL>
Set log level to output to console. LEVEL is either debug, info, notice, warn or
error. Default: notice
-D, --daemon[=true|false]
Run as daemon. The current working directory will be changed to / and standard
input, standard output and standard error will be redirected to /dev/null. Padrão:
false
--deferred-input[=true|false]
If true is given, aria2 does not read all URIs and options from file specified by
--input-file option at startup, but it reads one by one when it needs later. This
may reduce memory usage if input file contains a lot of URIs to download. If false
is given, aria2 reads all URIs and options at startup. Padrão: false
--disable-ipv6[=true|false]
Disable IPv6. This is useful if you have to use broken DNS and want to avoid
terribly slow AAAA record lookup. Padrão: false
--disk-cache=<SIZE>
Enable disk cache. If SIZE is 0, the disk cache is disabled. This feature caches
the downloaded data in memory, which grows to at most SIZE bytes. The cache storage
is created for aria2 instance and shared by all downloads. The one advantage of the
disk cache is reduce the disk I/O because the data are written in larger unit and
it is reordered by the offset of the file. If hash checking is involved and the
data are cached in memory, we don't need to read them from the disk. SIZE can
include K or M (1K = 1024, 1M = 1024K). Default: 16M
--download-result=<OPT>
This option changes the way Download Results is formatted. If OPT is default, print
GID, status, average download speed and path/URI. If multiple files are involved,
path/URI of first requested file is printed and remaining ones are omitted. If OPT
is full, print GID, status, average download speed, percentage of progress and
path/URI. The percentage of progress and path/URI are printed for each requested
file in each row. Padrão: default
--enable-async-dns6[=true|false]
Enable IPv6 name resolution in asynchronous DNS resolver. This option will be
ignored when --async-dns=false. Padrão: false
--enable-mmap[=true|false]
Map files into memory. This option may not work if the file space is not
pre-allocated. See --file-allocation.
Padrão: false
--event-poll=<POLL>
Specify the method for polling events. The possible values are epoll, kqueue,
port, poll and select. For each epoll, kqueue, port and poll, it is available if
system supports it. epoll is available on recent Linux. kqueue is available on
various *BSD systems including Mac OS X. port is available on Open Solaris. The
default value may vary depending on the system you use.
--file-allocation=<METHOD>
Specify file allocation method. 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. If you are using newer file systems such as ext4 (with
extents support), btrfs, xfs or NTFS(MinGW build only), falloc is your best choice.
It allocates large(few GiB) files almost instantly. Don't use falloc with legacy
file systems such as ext3 and FAT32 because it takes almost same time as prealloc
and it blocks aria2 entirely until allocation finishes. falloc may not be available
if your system doesn't have posix_fallocate(3) function. trunc uses ftruncate(2)
system call or platform-specific counterpart to truncate a file to a specified
length.
Possible Values: none, prealloc, trunc, falloc Padrão: prealloc
--force-save[=true|false]
Save download with --save-session option even if the download is completed or
removed. This may be useful to save BitTorrent seeding which is recognized as
completed state. Default: false
--gid=<GID>
Set GID manually. aria2 identifies each download by the ID called GID. The GID must
be hex string of 16 characters, thus [0-9a-zA-Z] are allowed and leading zeros must
not be stripped. The GID all 0 is reserved and must not be used. The GID must be
unique, otherwise error is reported and the download is not added. This option is
useful when restoring the sessions saved using --save-session option. If this
option is not used, new GID is generated by aria2.
--hash-check-only[=true|false]
If true is given, after hash check using --check-integrity option, abort download
whether or not download is complete. Padrão: false
--human-readable[=true|false]
Print sizes and speed in human readable format (e.g., 1.2Ki, 3.4Mi) in the console
readout. Padrão: true
--interface=<INTERFACE>
Bind sockets to given interface. You can specify interface name, IP address and
hostname. Possible Values: interface, IP address, hostname
NOTA:
If an interface has multiple addresses, it is highly recommended to specify IP
address explicitly. See also --disable-ipv6. If your system doesn't have
getifaddrs(3), this option doesn't accept interface name.
--max-download-result=<NÚMERO>
Set maximum number of download result kept in memory. The download results are
completed/error/removed downloads. The download results are stored in FIFO queue
and it can store at most NUM download results. When queue is full and new download
result is created, oldest download result is removed from the front of the queue
and new one is pushed to the back. Setting big number in this option may result
high memory consumption after thousands of downloads. Specifying 0 means no
download result is kept. Padrão: 1000
--max-resume-failure-tries=<N>
When used with --always-resume=false, aria2 downloads file from scratch when aria2
detects N number of URIs that does not support resume. If N is 0, aria2 downloads
file from scratch when all given URIs do not support resume. See --always-resume
option. Padrão: 0
--log-level=<LEVEL>
Set log level to output. LEVEL is either debug, info, notice, warn or error.
Padrão: debug
--on-bt-download-complete=<COMMAND>
For BitTorrent, a command specified in --on-download-complete is called after
download completed and seeding is over. On the other hand, this option set the
command to be executed after download completed but before seeding. See Interação
com Eventos (Hook) for more details about COMMAND. Possible Values:
/path/to/command
--on-download-complete=<COMMAND>
Set the command to be executed after download completed. See See Interação com
Eventos (Hook) for more details about COMMAND. See also --on-download-stop option.
Possible Values: /path/to/command
--on-download-error=<COMMAND>
Set the command to be executed after download aborted due to error. See Interação
com Eventos (Hook) for more details about COMMAND. See also --on-download-stop
option. Possible Values: /path/to/command
--on-download-pause=<COMMAND>
Set the command to be executed after download was paused. See Interação com
Eventos (Hook) for more details about COMMAND. Possible Values: /path/to/command
--on-download-start=<COMMAND>
Set the command to be executed after download got started. See Interação com
Eventos (Hook) for more details about COMMAND. Possible Values: /path/to/command
--on-download-stop=<COMMAND>
Set the command to be executed after download stopped. You can override the command
to be executed for particular download result using --on-download-complete and
--on-download-error. If they are specified, command specified in this option is not
executed. See Interação com Eventos (Hook) for more details about COMMAND.
Possible Values: /path/to/command
--piece-length=<LENGTH>
Set a piece length for HTTP e FTP downloads. This is the boundary when aria2 splits
a file. All splits occur at multiple of this length. This option will be ignored in
BitTorrent downloads. It will be also ignored if Metalink file contains piece
hashes. Padrão: 1M
NOTA:
The possible usecase of --piece-length option is change the request range in one
HTTP pipelined request. To enable HTTP pipelining use --enable-http-pipelining.
--show-console-readout[=true|false]
Show console readout. Padrão: true
--summary-interval=<SEGUNDOS>
Set interval in seconds to output download progress summary. Setting 0 suppresses
the output. Padrão: 60
NOTA:
In multi file torrent downloads, the files adjacent forward to the specified
files are also allocated if they share the 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. Padrão: false
--max-overall-download-limit=<VELOCIDADE>
Set max overall download speed in bytes/sec. 0 means unrestricted. You can append
K or M (1K = 1024, 1M = 1024K). To limit the download speed per download, use
--max-download-limit option. Padrão: 0
--max-download-limit=<VELOCIDADE>
Set max download speed per each download in bytes/sec. 0 means unrestricted. You
can append K or M (1K = 1024, 1M = 1024K). To limit the overall download speed,
use --max-overall-download-limit option. Padrão: 0
--no-conf[=true|false]
Disable loading aria2.conf file.
--no-file-allocation-limit=<TAMANHO>
No file allocation is made for files whose size is smaller than SIZE. You can
append K or M (1K = 1024, 1M = 1024K). Padrão: 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. Padrão: false
-q, --quiet[=true|false]
Make aria2 quiet (no console output). Padrão: false
--realtime-chunk-checksum[=true|false]
Validate chunk of data by calculating checksum while downloading a file if chunk
checksums are provided. Padrão: true
--remove-control-file[=true|false]
Remove control file before download. Using with --allow-overwrite=true, download
always starts from scratch. This will be useful for users behind proxy server which
disables resume.
--save-session=<ARQUIVO>
Salvar downloads não concluídos ou com erro, para um ARQUIVO quando sair. Pode ser
informado o nome do arquivo para o aria2 com a opção --input-file no restart. Note
que downloads adicionados pela função aria2.addTorrent() e pela função
aria2.addMetalink() método RPC e seus respectivos metadados não podem ser salvos.
Downloads removidos usando a função aria2.remove() e aria2.forceRemove() não serão
salvos.
--save-session-interval=<SEC>
Save error/unfinished downloads to a file specified by --save-session option every
SEC seconds. If 0 is given, file will be saved only when aria2 exits. Default: 0
--stop=<SEGUNDOS>
Finaliza a aplicação após SEGUNDOS se passarem. Se 0 é informado, essa
funcionalidade é desabilitada. Padrão: 0
--stop-with-process=<PID>
Finaliza a aplicação quando o processo de número PID não estiver executando. Isso
é útil se o processo aria2 foi derivado de um processo precursor. O processo
precursor pode ter criado o processo aria2 com seu próprio pid e quando o processo
precursor terminar por alguma razão, aria2 pode detectar por ele mesmo, essa
situação e executar ele mesmo o shutdown. Este recurso evita que um processo gere
subprocessos que ficam no limbo.
--truncate-console-readout[=true|false]
Truncar a linha da console para ajustar-se a uma linha. Padrão: true
-v, --version
Exibe o número da versão, copyright e informação da configuração e sai.
Argumento(s) Opcional(is)
As opções que possuem seus argumentos delimitados por colchetes ([]), são opcionais.
Normalmente omitindo o argumento, ele será assumido como true (verdadeiro). Se for usada
a forma abreviada dessas opções (como em -V) e informado um argumento, estão o nome da
opção e seu argumento devem ser concatenados, por exemplo: (-Vfalse). Se houver espaços
entre a opção e o argumento o argumento será tratado como URI e normalmente não é isto o
esperado.
Unidades (K and M)
Algumas opções usam K e M para convenientemente representar 1.024 e 1.048.576
respectivamente. aria2 detecta estas caracteres de maneira transparente (maiúsculas e
minúsculas), portanto podem ser usados k` ou K e m ou M.
URI, MAGNET, TORRENT_FILE, METALINK_FILE
Podemos especificar múltiplas URIs em uma linha de comando. A menos que seja especificada
a opção --force-sequential, todas as URIs devem apontar para o mesmo arquivo que será
baixado ou o download falhará.
Pode-se especificar um número arbitrátio de URIs de BitTorrent Magnet URI. Nove que eles
sempre serão tratados como downloads separados. São suportados Hash de Info de 40
characters e Hast de Info Base32 de 32 characters. Múltiplos parâmetros tr são
suportados. Devido a URI BitTorrent Magnet poder conter o caracter &, é altamente
recomendável delimitar a URI com apóstrofo single(') ou aspas double("). É altamente
recomendável habilitar DHT especialmente quando tr o parâmetro estiver ausente. Ver
http://www.bittorrent.org/beps/bep_0009.html para maiores detalhes sobre URI BitTorrent
Magnet.
Pode-se também especificar um número arbitrário de arquivos torrent e Documentos Metalink
armazenados em um dispositivo local. Note que sempre serão tratados como download
distintos. Tanto Metalink4 quanto Metalink da versão 3 são suportados.
Pode-se especificar arquivo torrent usando a opção -T e URI. Fazendo isso o download será
baixado do servidor swarm e HTTP, HTTPS e FTP ao mesmo tempo, enquanto os dados do HTTP,
HTTPS e FTP serão uploaded para o swarm torrent. Para torrent de um arquivo a URI deve
ser completa e apontar inclusive o recurso ou se a URI terminar com / o nome do torrent
será adicionado. Para múltiplos torrents, name e caminho serão adicionados para formar a
URI, para cada um dos arquivos.
NOTA:
Certifique-se que a URI seja delimitada por apóstrofo single(') ou aspas double(") se a
URI contiver & ou qualquer outro caracter que tenha significado especial para o shell.
Continuar Download Interrompido
Normalmente pode-se retomar uma transferência apenas executando-se o comando aria2c URI,
caso a transferência anterior estava sendo feita pelo aria2.
Caso a transferência anterior estava sendo feita por um navegador ou wget de maneira
sequencial, então utilize a opção --continue para retomar do ponto onde foi interrompida a
transferência.
Interação com Eventos (Hook)
aria2 possui opções para especificar comando arbitrário após um evento específico ocorrer.
Atualmente as seguintes opções estão disponíveis:
--on-bt-download-complete, --on-download-pause, --on-download-complete.
--on-download-start, --on-download-error, --on-download-stop.
aria2 passa 3 argumentos para um comando especificado quando este comando for executado.
Estes argumentos são: GID, o número de arquivos e o caminho dos arquivos. Para downloads
HTTP, HTTPS e FTP normalmente o número de arquivos é 1. BitTorrent podem conter múltiplos
arquivos. Se o número de arquivos é maior que 1, o caminho do arquivo é o primeiro. Em
outras palavras, este é o valor da chave path da primeira estrutura se aquela chave for
verdadeira como resposta do método da função aria2.getFiles() RPC. Se for necessário
todos os caminhos dos arquivos, considere usar o método JSON-RPC/XML-RPC. Lembre-se que o
caminho do arquivo pode ser modificado durante o download no HTTP por causa do
redirecionamento ou Disposição do Conteúdo do Cabeçalho.
Observemos um exemplo de como são passados argumentos para um comando:
$ cat hook.sh
#!/bin/sh
echo "chamado com [$1] [$2] [$3]"
$ aria2c --on-download-complete hook.sh http://dobrasil.org/arquivo.iso
chamado com [1] [1] [/caminho/para/arquivo.iso]
CÓDIGO DE RETORNO OU SAÍDA
Como aria2 pode manipular múltiplos downloads concomitantemente, podem ser encontrados
vários erros durante uma sessão. aria2 retorna os códigos de retorno ou saída com base no
último erro encontrado.
0 Se todos os downloads terminam com sucesso.
1 Erro desconhecido ocorreu.
2 Tempo transcorrido (time out).
3 Recurso não encontrado.
4 Se aria2 tentou um número especificado de vezes e obteve "recurso não encontrado".
Ver opção --max-file-not-found.
5 Se download interrompido porque a velocidade de download é muito baixa. Ver opção
--lowest-speed-limit
6 Erro na rede (network).
7 Se existem downloads não concluidos. Esse erro é reportado somente se todos os
downloads foram concluídos com sucesso mas existe uma fila quando aria2 foi
interrompido por quando foi pressionado Ctrl-C pelo usuário ou enviado o sinal TERM
ou INT.
8 Se o servidor remoto não suporta retomar um download que deve ser completado.
9 Não há espaço em disco suficiente para os downloads.
10 Se o tamanho do pedaço (piece) foi diferente do arquivo de controle .aria2. Ver
opção --allow-piece-length-change.
11 Se aria2 estava fazendo o download do mesmo arquivo no momento.
12 If aria2 estava fazendo o download do mesmo, hash do torrent, no momento.
13 Se o arquivo já existe. Ver opção --allow-overwrite.
14 Se renomer o arquivo falhou. Ver opção --auto-file-renaming.
15 Se aria2 não pode abrir o arquivo existente.
16 Se aria2 não pode criar novo arquivo ou truncar um arquivo já existente.
17 Se ocorreu erro de I/O no arquivo.
18 Se aria2 não pode criar diretório.
19 Se resolução de nomes falhou.
20 Se aria2 não pode passar documento Metalink.
21 Se comando FTP falhou.
22 Se cabeçalho de resposta HTTP está errado ou inesperado.
23 Se muitos redirecionamentos ocorreram.
24 Se autorização HTTP falhou.
25 Se aria2 não pode passar arquivo bencoded file (normalmente arq. ".torrent").
26 Se arquivo ".torrent" estava corrompido ou inexistem informações que aria2
necessita.
27 Se URI Magnet URI está errada.
28 Se opção está errada ou não é reconhecida ou argumento inválido de uma opção foi
informado.
29 Se o servidor remoto não pode manusear uma requisição devido a sobrecarga
temporária ou manutenção.
30 Se aria2 não pode passar uma requisição JSON-RPC.
NOTA:
Um erro ocorrido em um download completado não será reportado como um status de saida
nem como código de retorno (exit status).
VARIÁVEIS DE AMBIENTE
aria2 reconhece as seguintes variáveis de ambiente.
http_proxy [http://][USUÁRIO:SENHA@]SERVIDOR[:PORTA]
Especifica o servidor para uso do HTTP. Sobrepõe o valor do http-proxy do arquivo
de configuração. A opção linha de comando --http-proxy sobrepõe este valor.
https_proxy [http://][USUÁRIO:SENHA@]SERVIDOR[:PORTA]
Especifica o servidor proxy para uso do HTTPS. Sobrepõe o valor do https-proxy do
arquivo de configuração. A opção linha de comando --https-proxy sobrepõe este
valor.
ftp_proxy [http://][USUÁRIO:SENHA@]SERVIDOR[:PORTA]
Especifica o servidor proxy para uso do FTP. Sobrepõe o valor do http-proxy do
arquivo de configuração. A opção linha de comando --ftp-proxy sobrepõe este valor.
all_proxy [http://][USUÁRIO:SENHA@]SERVIDOR[:PORTA]
Especifica o servidor proxy para uso se nenhum protocolo-específico de proxy é
informado. Sobrepõe o valor all-proxy do arquivo de configuração. A opção linha
de comando --all-proxy sobrepõe este valor.
NOTA:
Apesar de aria2 aceitar os esquemas ftp:// e https:// para proxy de URI, aria2 assume
que http:// é especificado e não troca o comportamento com base no esquema
especificado.
no_proxy [DOMÍNIO,...]
Especifica nome de servidores, separados por vírgula, domínios e endereços de rede
com ou sem blocos CIDR para os quais não será usado proxy. Sobrepõe o valor
no-proxy do arquivo de configuração. A opção linha de comando --no-proxy sobrepõe
este valor.
ARQUIVOS DE CONFIGURAÇÃO
aria2.conf
Por padrão, aria2 utiliza $HOME/.aria2/aria2.conf como arquivo de configuração. Pode ser
especificado o caminho do arquivo usando-se a opção --conf-path. Se não desejar usar a
configuração de arquivo utilize a opção --no-conf.
O arquivo de configuração é um arquivo texto e possui uma opção por linha. Em cada linha,
deve haver um par (nome-valor), no formato: NOME=VALOR, onde nome é o nome longo da linha
de comando sem o prefixo --. Pode ser usada a mesma sintaxe da opção da linha de comando.
Linhas que começam com # são tratados como comentários:
# arquivo de simples configuração para aria2c
listen-port=60000
dht-listen-port=60000
seed-ratio=1.0
max-upload-limit=50K
ftp-pasv=true
NOTA:
Informações confidenciais como usuário/senha podem ser incluídas no arquivo de
configuração, mas recomenda-se trocar os bits de seu modo de acesso (por exemplo: chmod
600 aria2.conf), dessa maneira nenhum outro usuário consegue ver o conteúdo desse
arquivo de configuração.
dht.dat
Por padrão, a tabela de rota do IPv4 DHT está em $HOME/.aria2/dht.dat e a tabela de rota
do IPv6 DHT está em $HOME/.aria2/dht6.dat.
Netrc
Por padrão, o suporte a Netrc está habilitado para HTTP, HTTPS e FTP. Para desabilitar o
suporte a netrc especificar --no-netrc. Seu arquivo .netrc precisa ter as permissões
corretas (600).
Se o nome do servidor inicia com ., aria2 executa pesquisa domínio ao invés de pesquisa
exata. Isto é uma extensão de aria2. Exemplo de pesquisa de domínio, imagine as seguinte
entrada no arquivo .netrc:
machine .dobrasil.org login meuid password minhasenha
aria2.dobrasil.org pesquisa domínio .dobrasil.org e usa meuid e minhasenha.
Mais exemplos de pesquisa domínio: nobrasil.net não executa pesquisa domínio
.nobrasil.net. dobrasil.org não faz pesquisa domínio .dobrasil.org pois tem maior
amplitude hierárquica por causa do ponto precedente .. Se desejar utilizar dobrasil.org,
especificar dobrasil.org.
Arquivo de Controle
aria2 utiliza um arquivo de controle para rastrear o progresso de um download. Este
arquivo é gravado no mesmo diretório do arquivo que está sendo baixado e possui o sufixo
.aria2. Por exemplo,se está baixando arquivo.zip, então o arquivo de controle será
arquivo.zip.aria2. (Existe apenas uma exceção para essa convenção que é quando você está
baixando um multi torrent, o arquivo de controle estará no "diretório topo" do torrent com
o sufixo .aria2. O nome do "diretório topo" é o valor da chave "name" no diretório "info"
do arquivo torrent).
Normalmente um arquivo controle é apagado quando o download se completa. Se aria2 detecta
que o download não pode ser retomado (por exemplo, quando faz download de um servidor HTTP
que não suporta retomar o processamento de um ponto mas sempre do início), o arquivo de
controle não será criado.
Se você perder o arquivo de controle, não será possivel retomar o download do ponto onde
estava. Mas se há um torrent ou metalink com checksum (verificação) do arquivo, poderá ser
retomado do último ponto especificando a opção -V na linha de comando.
Arquivo de Entrada
O arquivo de entrada pode conter uma lista de URIs para que o aria2 efetua download.
Podem ser especificados múltiplas URIs para cada simples entidade: separar as entidades
por um caracter TAB ou espaço.
Cada linha é tratada como se fosse especificada através de um argumento da linha de
comando. Entretando estas linhas são afetadas pela opção --force-sequential e pela opção
--parameterized-uri
Quando as URIs do arquivo de entrada são diretamente lidas pelo aria2, as URIs não
precisam necessáriamente estarem delimitadas por apóstrofo (') nem aspas(").
Linhas que começam com # são tratadas como comentário e desprezadas.
Adicionalmente, as seguintes opções podem ser especificadas após cada linha de URI. Estas
linhas opcionais precisam iniciar com um ou mais espaços.
• all-proxy
• all-proxy-passwd
• all-proxy-user
• allow-overwrite
• allow-piece-length-change
• always-resume
• async-dns
• auto-file-renaming
• bt-enable-lpd
• bt-exclude-tracker
• bt-external-ip
• bt-hash-check-seed
• bt-max-open-files
• bt-max-peers
• bt-metadata-only
• bt-min-crypto-level
• bt-prioritize-piece
• bt-remove-unselected-file
• bt-request-peer-speed-limit
• bt-require-crypto
• bt-save-metadata
• bt-seed-unverified
• bt-stop-timeout
• bt-tracker
• bt-tracker-connect-timeout
• bt-tracker-interval
• bt-tracker-timeout
• check-integrity
• checksum
• conditional-get
• connect-timeout
• continue
• dir
• dry-run
• enable-async-dns6
• enable-http-keep-alive
• enable-http-pipelining
• enable-mmap
• enable-peer-exchange
• file-allocation
• follow-metalink
• follow-torrent
• force-save
• ftp-passwd
• ftp-pasv
• ftp-proxy
• ftp-proxy-passwd
• ftp-proxy-user
• ftp-reuse-connection
• ftp-type
• ftp-user
• hash-check-only
• header
• http-accept-gzip
• http-auth-challenge
• http-no-cache
• http-passwd
• http-proxy
• http-proxy-passwd
• http-proxy-user
• http-user
• https-proxy
• https-proxy-passwd
• https-proxy-user
• index-out
• lowest-speed-limit
• max-connection-per-server
• max-download-limit
• max-file-not-found
• max-resume-failure-tries
• max-tries
• max-upload-limit
• metalink-base-uri
• metalink-enable-unique-protocol
• metalink-language
• metalink-location
• metalink-os
• metalink-preferred-protocol
• metalink-version
• min-split-size
• no-file-allocation-limit
• no-netrc
• no-proxy
• out
• parameterized-uri
• pause
• piece-length
• proxy-method
• realtime-chunk-checksum
• referer
• remote-time
• remove-control-file
• retry-wait
• reuse-uri
• rpc-save-upload-metadata
• seed-ratio
• seed-time
• select-file
• split
• stream-piece-selector
• timeout
• uri-selector
• use-head
• user-agent
Estas opções possuem exatamente o mesmo significado das opções existentes na linha de
comando, mas aplicam-se apenas a URI a que pertencem. Por favor perceba que dentro de um
arquivo, elas não terão o prefixo --.
Por exemplo, o conteúdo do arquivo de entrada uri.txt é:
http://servidor/arquivo.iso http://espelho/arquivo.iso
dir=/imagens_iso
out=arquivo.img
http://fu/ba
Se aria2 é executado com as opções -i uri.txt -d /tmp, então o arquivo.iso será salvo como
/imagens_iso/arquivo.img e será baixado dos servidores http://servidor/arquivo.iso e
http://espelho/arquivo.iso. O arquivo ba e baixado de http://fu/ba e salvo como /tmp/ba.
Em alguns casos, o parâmetro out não tem efeito. Ver nota da opção --out para entender as
restrições.
Perfil Performance Servidor
Esta seção descreve o formato do perfil de performance do servidor, composto por um
arquivo de texto plano com cada linha contendo um par NOME=VALOR, delimitados por virgula.
Atualmente esta é a lista de nomes reconhecidos:
host Nome do servidor. Requerido.
protocol
Protocolo para este perfil, como ftp, http, https. http é requerido.
dl_speed
Velocidade média de download observada no download prévio, em bytes por segundo.
Requerido.
sc_avg_speed
The average download speed observed in the previous download in bytes per sec. This
value is only updated if the download is done in single connection environment and
only used by AdaptiveURISelector. Optional.
mc_avg_speed
The average download speed observed in the previous download in bytes per sec. This
value is only updated if the download is done in multi connection environment and
only used by AdaptiveURISelector. Optional.
counter
How many times the server is used. Currently this value is only used by
AdaptiveURISelector. Optional.
last_updated
Last contact time in GMT with this server, specified in the seconds since the
Epoch(00:00:00 on January 1, 1970, UTC). Required.
status ERROR is set when server cannot be reached or out-of-service or timeout occurred.
Otherwise, OK is set.
Estes campos devem existir em uma linha. A ordem dos campos não importa. Podem ser
colocados pares; eles serão simplesmente ignorados.
Um exemplo abaixo:
host=localhost, protocol=http, dl_speed=32000, last_updated=1222491640,
status=OK
host=localhost, protocol=ftp, dl_speed=0, last_updated=1222491632,
status=ERROR
INTERFACE RPC
aria2 provê o serviço JSON-RPC sobre HTTP e XML-RPC sobre HTTP e eles basicamente possuem
a mesma funcionalidade. aria2 também provê JSON-RPC sobre WebSocket que utiliza o mesmo
formato, do método e assinatura e de resposta do formato JSON-RPC sobre HTTP, mas
adicionalmente possui notificações iniciadas pelo servidor. Ver detalhes na seção
JSON-RPC sobre WebSocket .
O caminho requisitado do interface JSON-RPC (sobre HTTP e sobre WebSocket) é /jsonrpc. O
caminho requisitado do interface XML-RPC é /rpc.
A URI WebSocket para JSON-RPC sobre WebSocket é ws://HOST:PORT/jsonrpc.
A implementação JSON-RPC é baseada na especificação JSON-RPC 2.0
<http://jsonrpc.org/specification> e suporta HTTP POST e GET (JSONP). Usando WebSocket
como transporte, é uma extensão original do aria2.
A interface JSON-RPC não suporta notificação em HTTP, mas o servidor RPC irá enviar a
notificação no WebSocket. Não é suportado número de ponto flutuante O codificação de
página deve ser UTF-8.
Quanto a seguinte documentação do JSON-RPC, entenda estrutura JSON como objeto.
Terminologia
GID GID(or gid) é a chave para gerenciar cada download. Cada download tem um único GID.
Atualmente GID é armazenado em 64 bits como dado binário no aria2. Para acesso RPG,
isso é representado em uma string hexadecimal de 16 caracteres (exemplo:
2089b05ecca3d829). Normalmente, aria2 gera esse GID para cada download, mas o
usuário pode especificar o GID manualmente usando a opção --gid. Quando consultando
um download por GID, pode ser especificado o prefixo do GID como um prefixo único e
exclusivo entre outros.
Métodos
São descritos em torno de 35 exemplos, os quais serão numerados utilizando código fonte
com exemplos que usam a linguagem Python versão 2.7.
aria2.addUri(uris[, options[, position]])
This method adds new HTTP(S)/FTP/BitTorrent Magnet URI. uris is of type array and
its element is URI which is of type string. For BitTorrent Magnet URI, uris must
have only one element and it should be BitTorrent Magnet URI. URIs in uris must
point to the same file. If you mix other URIs which point to another file, aria2
does not complain but download may fail. options is of type struct and its members
are a pair of option name and value. See Opções below for more details. If
position is given as an integer starting from 0, the new download is inserted at
position in the waiting queue. If position is not given or position is larger than
the size of the queue, it is appended at the end of the queue. This method returns
GID of registered download.
JSON-RPC EXEMPLO M010
The following example adds http://example.org/file:
>>> import urllib2, json
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
... 'method':'aria2.addUri',
... 'params':[['http://example.org/file']]})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> c.read()
'{"id":"qwer","jsonrpc":"2.0","result":"2089b05ecca3d829"}'
XML-RPC EXEMPLO M020
The following example adds http://example.org/file:
>>> import xmlrpclib
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> s.aria2.addUri(['http://example.org/file'])
'2089b05ecca3d829'
The following example adds 2 sources and some options:
>>> s.aria2.addUri(['http://example.org/file', 'http://mirror/file'],
dict(dir="/tmp"))
'd2703803b52216d1'
The following example adds a download and insert it to the front of waiting
downloads:
>>> s.aria2.addUri(['http://example.org/file'], {}, 0)
'ca3d829cee549a4d'
aria2.addTorrent(torrent[, uris[, options[, position]]])
This method adds BitTorrent download by uploading ".torrent" file. If you want to
add BitTorrent Magnet URI, use aria2.addUri() method instead. torrent is of type
base64 which contains Base64-encoded ".torrent" file. uris is of type array and
its element is URI which is of type string. uris is used for Web-seeding. For
single file torrents, URI can be a complete URI pointing to the resource or if URI
ends with /, name in torrent file is added. For multi-file torrents, name and path
in torrent are added to form a URI for each file. options is of type struct and
its members are a pair of option name and value. See Opções below for more details.
If position is given as an integer starting from 0, the new download is inserted at
position in the waiting queue. If position is not given or position is larger than
the size of the queue, it is appended at the end of the queue. This method returns
GID of registered download. If --rpc-save-upload-metadata is true, the uploaded
data is saved as a file named hex string of SHA-1 hash of data plus ".torrent" in
the directory specified by --dir option. The example of filename is
0a3893293e27ac0490424c06de4d09242215f0a6.torrent. If same file already exists, it
is overwritten. If the file cannot be saved successfully or
--rpc-save-upload-metadata is false, the downloads added by this method are not
saved by --save-session.
The following examples add local file file.torrent.
JSON-RPC EXEMPLO M030
>>> import urllib2, json, base64
>>> torrent = base64.b64encode(open('file.torrent').read())
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'asdf',
... 'method':'aria2.addTorrent', 'params':[torrent]})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> c.read()
'{"id":"asdf","jsonrpc":"2.0","result":"2089b05ecca3d829"}'
XML-RPC EXEMPLO M040
>>> import xmlrpclib
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> s.aria2.addTorrent(xmlrpclib.Binary(open('file.torrent').read()))
'2089b05ecca3d829'
aria2.addMetalink(metalink[, options[, position]])
This method adds Metalink download by uploading ".metalink" file. metalink is of
type base64 which contains Base64-encoded ".metalink" file. options is of type
struct and its members are a pair of option name and value. See Opções below for
more details. If position is given as an integer starting from 0, the new download
is inserted at position in the waiting queue. If position is not given or position
is larger than the size of the queue, it is appended at the end of the queue. This
method returns array of GID of registered download. If --rpc-save-upload-metadata
is true, the uploaded data is saved as a file named hex string of SHA-1 hash of
data plus ".metalink" in the directory specified by --dir option. The example of
filename is 0a3893293e27ac0490424c06de4d09242215f0a6.metalink. If same file
already exists, it is overwritten. If the file cannot be saved successfully or
--rpc-save-upload-metadata is false, the downloads added by this method are not
saved by --save-session.
The following examples add local file file.meta4.
JSON-RPC EXEMPLO M050
>>> import urllib2, json, base64
>>> metalink = base64.b64encode(open('file.meta4').read())
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
... 'method':'aria2.addMetalink',
... 'params':[metalink]})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> c.read()
'{"id":"qwer","jsonrpc":"2.0","result":["2089b05ecca3d829"]}'
XML-RPC EXEMPLO M060
>>> import xmlrpclib
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> s.aria2.addMetalink(xmlrpclib.Binary(open('file.meta4').read()))
['2089b05ecca3d829']
aria2.remove(gid)
This method removes the download denoted by gid. gid is of type string. If
specified download is in progress, it is stopped at first. The status of removed
download becomes removed. This method returns GID of removed download.
The following examples remove download GID#2089b05ecca3d829.
JSON-RPC EXEMPLO M070
>>> import urllib2, json
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
... 'method':'aria2.remove',
... 'params':['2089b05ecca3d829']})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> c.read()
'{"id":"qwer","jsonrpc":"2.0","result":"2089b05ecca3d829"}'
XML-RPC EXEMPLO M080
>>> import xmlrpclib
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> s.aria2.remove('2089b05ecca3d829')
'2089b05ecca3d829'
aria2.forceRemove(gid)
This method removes the download denoted by gid. This method behaves just like
aria2.remove() except that this method removes download without any action which
takes time such as contacting BitTorrent tracker.
aria2.pause(gid)
This method pauses the download denoted by gid. gid is of type string. The status
of paused download becomes paused. If the download is active, the download is
placed on the first position of waiting queue. As long as the status is paused,
the download is not started. To change status to waiting, use aria2.unpause()
method. This method returns GID of paused download.
aria2.pauseAll()
This method is equal to calling aria2.pause() for every active/waiting download.
This methods returns OK for success.
aria2.forcePause(pid)
This method pauses the download denoted by gid. This method behaves just like
aria2.pause() except that this method pauses download without any action which
takes time such as contacting BitTorrent tracker.
aria2.forcePauseAll()
This method is equal to calling aria2.forcePause() for every active/waiting
download. This methods returns OK for success.
aria2.unpause(gid)
This method changes the status of the download denoted by gid from paused to
waiting. This makes the download eligible to restart. gid is of type string. This
method returns GID of unpaused download.
aria2.unpauseAll()
This method is equal to calling aria2.unpause() for every active/waiting download.
This methods returns OK for success.
aria2.tellStatus(gid[, keys])
This method returns download progress of the download denoted by gid. gid is of
type string. keys is array of string. If it is specified, the response contains
only keys in keys array. If keys is empty or not specified, the response contains
all keys. This is useful when you just want specific keys and avoid unnecessary
transfers. For example, aria2.tellStatus("2089b05ecca3d829", ["gid", "status"])
returns gid and 'status' key. The response is of type struct and it contains
following keys. The value type is string.
gid GID of this download.
status active for currently downloading/seeding entry. waiting for the entry in the
queue; download is not started. paused for the paused entry. error for the
stopped download because of error. complete for the stopped and completed
download. removed for the download removed by user.
totalLength
Total length of this download in bytes.
completedLength
Completed length of this download in bytes.
uploadLength
Uploaded length of this download in bytes.
bitfield
Hexadecimal representation of the download progress. The highest bit
corresponds to piece index 0. The set bits indicate the piece is available
and unset bits indicate the piece is missing. The spare bits at the end are
set to zero. When download has not started yet, this key will not be
included in the response.
downloadSpeed
Download speed of this download measured in bytes/sec.
uploadSpeed
Upload speed of this download measured in bytes/sec.
infoHash
InfoHash. BitTorrent only.
numSeeders
The number of seeders the client has connected to. BitTorrent only.
pieceLength
Piece length in bytes.
numPieces
The number of pieces.
connections
The number of peers/servers the client has connected to.
errorCode
The last error code occurred in this download. The value is of type string.
The error codes are defined in CÓDIGO DE RETORNO ou SAÍDA section. This
value is only available for stopped/completed downloads.
followedBy
List of GIDs which are generated by the consequence of this download. For
example, when aria2 downloaded Metalink file, it generates downloads
described in it(see --follow-metalink option). This value is useful to track
these auto generated downloads. If there is no such downloads, this key will
not be included in the response.
belongsTo
GID of a parent download. Some downloads are a part of another download.
For example, if a file in Metalink has BitTorrent resource, the download of
".torrent" is a part of that file. If this download has no parent, this key
will not be included in the response.
dir Directory to save files. This key is not available for stopped downloads.
files Returns the list of files. The element of list is the same struct used in
aria2.getFiles() method.
bittorrent
Struct which contains information retrieved from .torrent file. BitTorrent
only. It contains following keys.
announceList
List of lists of announce URI. If ".torrent" file contains announce
and no announce-list, announce is converted to announce-list format.
comment
The comment for the torrent. comment.utf-8 is used if available.
creationDate
The creation time of the torrent. The value is an integer since the
Epoch, measured in seconds.
mode File mode of the torrent. The value is either single or multi.
info Struct which contains data from Info dictionary. It contains
following keys.
name name in info dictionary. name.utf-8 is used if available.
JSON-RPC EXEMPLO M090
The following example gets information about download GID#2089b05ecca3d829:
>>> import urllib2, json
>>> from pprint import pprint
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
... 'method':'aria2.tellStatus',
... 'params':['2089b05ecca3d829']})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> pprint(json.loads(c.read()))
{u'id': u'qwer',
u'jsonrpc': u'2.0',
u'result': {u'bitfield': u'0000000000',
u'completedLength': u'901120',
u'connections': u'1',
u'dir': u'/downloads',
u'downloadSpeed': u'15158',
u'files': [{u'index': u'1',
u'length': u'34896138',
u'completedLength': u'34896138',
u'path': u'/downloads/file',
u'selected': u'true',
u'uris': [{u'status': u'used',
u'uri': u'http://example.org/file'}]}],
u'gid': u'2089b05ecca3d829',
u'numPieces': u'34',
u'pieceLength': u'1048576',
u'status': u'active',
u'totalLength': u'34896138',
u'uploadLength': u'0',
u'uploadSpeed': u'0'}}
The following example gets information specifying keys you are interested in:
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
... 'method':'aria2.tellStatus',
... 'params':['2089b05ecca3d829',
... ['gid',
... 'totalLength',
... 'completedLength']]})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> pprint(json.loads(c.read()))
{u'id': u'qwer',
u'jsonrpc': u'2.0',
u'result': {u'completedLength': u'5701632',
u'gid': u'2089b05ecca3d829',
u'totalLength': u'34896138'}}
XML-RPC EXEMPLO M100
The following example gets information about download GID#2089b05ecca3d829:
>>> import xmlrpclib
>>> from pprint import pprint
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> r = s.aria2.tellStatus('2089b05ecca3d829')
>>> pprint(r)
{'bitfield': 'ffff80',
'completedLength': '34896138',
'connections': '0',
'dir': '/downloads',
'downloadSpeed': '0',
'errorCode': '0',
'files': [{'index': '1',
'length': '34896138',
'completedLength': '34896138',
'path': '/downloads/file',
'selected': 'true',
'uris': [{'status': 'used',
'uri': 'http://example.org/file'}]}],
'gid': '2089b05ecca3d829',
'numPieces': '17',
'pieceLength': '2097152',
'status': 'complete',
'totalLength': '34896138',
'uploadLength': '0',
'uploadSpeed': '0'}
The following example gets information specifying keys you are interested in:
>>> r = s.aria2.tellStatus('2089b05ecca3d829', ['gid', 'totalLength', 'completedLength'])
>>> pprint(r)
{'completedLength': '34896138', 'gid': '2089b05ecca3d829', 'totalLength': '34896138'}
aria2.getUris(gid)
This method returns URIs used in the download denoted by gid. gid is of type
string. The response is of type array and its element is of type struct and it
contains following keys. The value type is string.
uri URI
status 'used' if the URI is already used. 'waiting' if the URI is waiting in the
queue.
JSON-RPC EXEMPLO M110
>>> import urllib2, json
>>> from pprint import pprint
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
... 'method':'aria2.getUris',
... 'params':['2089b05ecca3d829']})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> pprint(json.loads(c.read()))
{u'id': u'qwer',
u'jsonrpc': u'2.0',
u'result': [{u'status': u'used',
u'uri': u'http://example.org/file'}]}
XML-RPC EXEMPLO M120
>>> import xmlrpclib
>>> from pprint import pprint
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> r = s.aria2.getUris('2089b05ecca3d829')
>>> pprint(r)
[{'status': 'used', 'uri': 'http://example.org/file'}]
aria2.getFiles(gid)
This method returns file list of the download denoted by gid. gid is of type
string. The response is of type array and its element is of type struct and it
contains following keys. The value type is string.
index Index of file. Starting with 1. This is the same order with the files in
multi-file torrent.
path File path.
length File size in bytes.
completedLength
Completed length of this file in bytes. Please note that it is possible
that sum of completedLength is less than completedLength in
aria2.tellStatus() method. This is because completedLength in
aria2.getFiles() only calculates completed pieces. On the other hand,
completedLength in aria2.tellStatus() takes into account of partially
completed piece.
selected
true if this file is selected by --select-file option. If --select-file is
not specified or this is single torrent or no torrent download, this value
is always true. Otherwise false.
uris Returns the list of URI for this file. The element of list is the same
struct used in aria2.getUris() method.
JSON-RPC EXEMPLO M130
>>> import urllib2, json
>>> from pprint import pprint
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
... 'method':'aria2.getFiles',
... 'params':['2089b05ecca3d829']})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> pprint(json.loads(c.read()))
{u'id': u'qwer',
u'jsonrpc': u'2.0',
u'result': [{u'index': u'1',
u'length': u'34896138',
u'completedLength': u'34896138',
u'path': u'/downloads/file',
u'selected': u'true',
u'uris': [{u'status': u'used',
u'uri': u'http://example.org/file'}]}]}
XML-RPC EXEMPLO M140
>>> import xmlrpclib
>>> from pprint import pprint
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> r = s.aria2.getFiles('2089b05ecca3d829')
>>> pprint(r)
[{'index': '1',
'length': '34896138',
'completedLength': '34896138',
'path': '/downloads/file',
'selected': 'true',
'uris': [{'status': 'used',
'uri': 'http://example.org/file'}]}]
aria2.getPeers(gid)
This method returns peer list of the download denoted by gid. gid is of type
string. This method is for BitTorrent only. The response is of type array and its
element is of type struct and it contains following keys. The value type is string.
peerId Percent-encoded peer ID.
ip IP address of the peer.
port Port number of the peer.
bitfield
Hexadecimal representation of the download progress of the peer. The highest
bit corresponds to piece index 0. The set bits indicate the piece is
available and unset bits indicate the piece is missing. The spare bits at
the end are set to zero.
amChoking
true if this client is choking the peer. Otherwise false.
peerChoking
true if the peer is choking this client. Otherwise false.
downloadSpeed
Download speed (byte/sec) that this client obtains from the peer.
uploadSpeed
Upload speed(byte/sec) that this client uploads to the peer.
seeder true is this client is a seeder. Otherwise false.
JSON-RPC EXEMPLO M150
>>> import urllib2, json
>>> from pprint import pprint
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
... 'method':'aria2.getPeers',
... 'params':['2089b05ecca3d829']})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> pprint(json.loads(c.read()))
{u'id': u'qwer',
u'jsonrpc': u'2.0',
u'result': [{u'amChoking': u'true',
u'bitfield': u'ffffffffffffffffffffffffffffffffffffffff',
u'downloadSpeed': u'10602',
u'ip': u'10.0.0.9',
u'peerChoking': u'false',
u'peerId': u'aria2%2F1%2E10%2E5%2D%87%2A%EDz%2F%F7%E6',
u'port': u'6881',
u'seeder': u'true',
u'uploadSpeed': u'0'},
{u'amChoking': u'false',
u'bitfield': u'ffffeff0fffffffbfffffff9fffffcfff7f4ffff',
u'downloadSpeed': u'8654',
u'ip': u'10.0.0.30',
u'peerChoking': u'false',
u'peerId': u'bittorrent client758',
u'port': u'37842',
u'seeder': u'false',
u'uploadSpeed': u'6890'}]}
XML-RPC EXEMPLO M160
>>> import xmlrpclib
>>> from pprint import pprint
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> r = s.aria2.getPeers('2089b05ecca3d829')
>>> pprint(r)
[{'amChoking': 'true',
'bitfield': 'ffffffffffffffffffffffffffffffffffffffff',
'downloadSpeed': '10602',
'ip': '10.0.0.9',
'peerChoking': 'false',
'peerId': 'aria2%2F1%2E10%2E5%2D%87%2A%EDz%2F%F7%E6',
'port': '6881',
'seeder': 'true',
'uploadSpeed': '0'},
{'amChoking': 'false',
'bitfield': 'ffffeff0fffffffbfffffff9fffffcfff7f4ffff',
'downloadSpeed': '8654',
'ip': '10.0.0.30',
'peerChoking': 'false',
'peerId': 'bittorrent client758',
'port': '37842',
'seeder': 'false,
'uploadSpeed': '6890'}]
aria2.getServers(gid)
This method returns currently connected HTTP, HTTPS, FTP servers of the download
denoted by gid. gid is of type string. The response is of type array and its
element is of type struct and it contains following keys. The value type is string.
index Index of file. Starting with 1. This is the same order with the files in
multi-file torrent.
servers
The list of struct which contains following keys.
uri URI originally added.
currentUri
This is the URI currently used for downloading. If redirection is
involved, currentUri and uri may differ.
downloadSpeed
Download speed (byte/sec)
JSON-RPC EXEMPLO M170
>>> import urllib2, json
>>> from pprint import pprint
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
... 'method':'aria2.getServers',
... 'params':['2089b05ecca3d829']})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> pprint(json.loads(c.read()))
{u'id': u'qwer',
u'jsonrpc': u'2.0',
u'result': [{u'index': u'1',
u'servers': [{u'currentUri': u'http://example.org/file',
u'downloadSpeed': u'10467',
u'uri': u'http://example.org/file'}]}]}
XML-RPC EXEMPLO M180
>>> import xmlrpclib
>>> from pprint import pprint
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> r = s.aria2.getServers('2089b05ecca3d829')
>>> pprint(r)
[{'index': '1',
'servers': [{'currentUri': 'http://example.org/dl/file',
'downloadSpeed': '20285',
'uri': 'http://example.org/file'}]}]
aria2.tellActive([keys])
This method returns the list of active downloads. The response is of type array
and its element is the same struct returned by aria2.tellStatus() method. For keys
parameter, please refer to aria2.tellStatus() method.
aria2.tellWaiting(offset, num[, keys])
This method returns the list of waiting download, including paused downloads.
offset is of type integer and specifies the offset from the download waiting at the
front. num is of type integer and specifies the number of downloads to be returned.
For keys parameter, please refer to aria2.tellStatus() method.
If offset is a positive integer, this method returns downloads in the range of
[offset, offset + num).
offset can be a negative integer. offset == -1 points last download in the waiting
queue and offset == -2 points the download before the last download, and so on. The
downloads in the response are in reversed order.
For example, imagine that three downloads "A","B" and "C" are waiting in this
order. aria2.tellWaiting(0, 1) returns ["A"]. aria2.tellWaiting(1, 2) returns ["B",
"C"]. aria2.tellWaiting(-1, 2) returns ["C", "B"].
The response is of type array and its element is the same struct returned by
aria2.tellStatus() method.
aria2.tellStopped(offset, num[, keys])
This method returns the list of stopped download. offset is of type integer and
specifies the offset from the oldest download. num is of type integer and specifies
the number of downloads to be returned. For keys parameter, please refer to
aria2.tellStatus() method.
offset and num have the same semantics as aria2.tellWaiting() method.
The response is of type array and its element is the same struct returned by
aria2.tellStatus() method.
aria2.changePosition(gid, pos, how)
This method changes the position of the download denoted by gid. pos is of type
integer. how is of type string. If how is POS_SET, it moves the download to a
position relative to the beginning of the queue. If how is POS_CUR, it moves the
download to a position relative to the current position. If how is POS_END, it
moves the download to a position relative to the end of the queue. If the
destination position is less than 0 or beyond the end of the queue, it moves the
download to the beginning or the end of the queue respectively. The response is of
type integer and it is the destination position.
For example, if GID#2089b05ecca3d829 is placed in position 3,
aria2.changePosition('2089b05ecca3d829', -1, 'POS_CUR') will change its position to
2. Additional aria2.changePosition('2089b05ecca3d829', 0, 'POS_SET') will change
its position to 0(the beginning of the queue).
The following examples move the download GID#2089b05ecca3d829 to the front of the
waiting queue.
JSON-RPC EXEMPLO M190
>>> import urllib2, json
>>> from pprint import pprint
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
... 'method':'aria2.changePosition',
... 'params':['2089b05ecca3d829', 0, 'POS_SET']})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> pprint(json.loads(c.read()))
{u'id': u'qwer', u'jsonrpc': u'2.0', u'result': 0}
XML-RPC EXEMPLO M200
>>> import xmlrpclib
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> s.aria2.changePosition('2089b05ecca3d829', 0, 'POS_SET')
0
aria2.changeUri(gid, fileIndex, delUris, addUris[, position])
This method removes URIs in delUris from and appends URIs in addUris to download
denoted by gid. delUris and addUris are list of string. A download can contain
multiple files and URIs are attached to each file. fileIndex is used to select
which file to remove/attach given URIs. fileIndex is 1-based. position is used to
specify where URIs are inserted in the existing waiting URI list. position is
0-based. When position is omitted, URIs are appended to the back of the list. This
method first execute removal and then addition. position is the position after URIs
are removed, not the position when this method is called. When removing URI, if
same URIs exist in download, only one of them is removed for each URI in delUris.
In other words, there are three URIs http://example.org/aria2 and you want remove
them all, you have to specify (at least) 3 http://example.org/aria2 in delUris.
This method returns a list which contains 2 integers. The first integer is the
number of URIs deleted. The second integer is the number of URIs added.
The following examples add 1 URI http://example.org/file to the file whose index is
1 and belongs to the download GID#2089b05ecca3d829.
JSON-RPC EXEMPLO M210
>>> import urllib2, json
>>> from pprint import pprint
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
... 'method':'aria2.changeUri',
... 'params':['2089b05ecca3d829', 1, [],
['http://example.org/file']]})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> pprint(json.loads(c.read()))
{u'id': u'qwer', u'jsonrpc': u'2.0', u'result': [0, 1]}
XML-RPC EXEMPLO M220
>>> import xmlrpclib
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> s.aria2.changeUri('2089b05ecca3d829', 1, [],
['http://example.org/file'])
[0, 1]
aria2.getOption(gid)
This method returns options of the download denoted by gid. The response is of
type struct. Its key is the name of option. The value type is string. Note that
this method does not return options which have no default value and have not been
set by the command-line options, configuration files or RPC methods.
The following examples get options of the download GID#2089b05ecca3d829.
JSON-RPC EXEMPLO M230
>>> import urllib2, json
>>> from pprint import pprint
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
... 'method':'aria2.getOption',
... 'params':['2089b05ecca3d829']})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> pprint(json.loads(c.read()))
{u'id': u'qwer',
u'jsonrpc': u'2.0',
u'result': {u'allow-overwrite': u'false',
u'allow-piece-length-change': u'false',
u'always-resume': u'true',
u'async-dns': u'true',
...
XML-RPC EXEMPLO M240
>>> import xmlrpclib
>>> from pprint import pprint
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> r = s.aria2.getOption('2089b05ecca3d829')
>>> pprint(r)
{'allow-overwrite': 'false',
'allow-piece-length-change': 'false',
'always-resume': 'true',
'async-dns': 'true',
....
aria2.changeOption(gid, options)
This method changes options of the download denoted by gid dynamically. gid is of
type string. options is of type struct. The following options are available for
active downloads:
• bt-max-peers
• bt-request-peer-speed-limit
• bt-remove-unselected-file
• force-save
• max-download-limit
• max-upload-limit
For waiting or paused downloads, in addition to the above options, options listed
in Arquivo de Entrada subsection are available, except for following options:
dry-run, metalink-base-uri, parameterized-uri, pause, piece-length and
rpc-save-upload-metadata option. This method returns OK for success.
The following examples set max-download-limit option to 20K for the download
GID#2089b05ecca3d829.
JSON-RPC EXEMPLO M250
>>> import urllib2, json
>>> from pprint import pprint
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
... 'method':'aria2.changeOption',
... 'params':['2089b05ecca3d829',
... {'max-download-limit':'10K'}]})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> pprint(json.loads(c.read()))
{u'id': u'qwer', u'jsonrpc': u'2.0', u'result': u'OK'}
XML-RPC EXEMPLO M260
>>> import xmlrpclib
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> s.aria2.changeOption('2089b05ecca3d829', {'max-download-limit':'20K'})
'OK'
aria2.getGlobalOption()
This method returns global options. The response is of type struct. Its key is the
name of option. The value type is string. Note that this method does not return
options which have no default value and have not been set by the command-line
options, configuration files or RPC methods. Because global options are used as a
template for the options of newly added download, the response contains keys
returned by aria2.getOption() method.
aria2.changeGlobalOption(options)
This method changes global options dynamically. options is of type struct. The
following options are available:
• download-result
• log
• log-level
• max-concurrent-downloads
• max-download-result
• max-overall-download-limit
• max-overall-upload-limit
• save-cookies
• save-session
• server-stat-of
In addition to them, options listed in Arquivo de Entrada subsection are available,
except for following options: checksum, index-out, out, pause and select-file.
Using log option, you can dynamically start logging or change log file. To stop
logging, give empty string("") as a parameter value. Note that log file is always
opened in append mode. This method returns OK for success.
aria2.getGlobalStat()
This method returns global statistics such as overall download and upload speed.
The response is of type struct and contains following keys. The value type is
string.
downloadSpeed
Overall download speed (byte/sec).
uploadSpeed
Overall upload speed(byte/sec).
numActive
The number of active downloads.
numWaiting
The number of waiting downloads.
numStopped
The number of stopped downloads.
JSON-RPC EXEMPLO M270
>>> import urllib2, json
>>> from pprint import pprint
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
... 'method':'aria2.getGlobalStat'})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> pprint(json.loads(c.read()))
{u'id': u'qwer',
u'jsonrpc': u'2.0',
u'result': {u'downloadSpeed': u'21846',
u'numActive': u'2',
u'numStopped': u'0',
u'numWaiting': u'0',
u'uploadSpeed': u'0'}}
XML-RPC EXEMPLO M280
>>> import xmlrpclib
>>> from pprint import pprint
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> r = s.aria2.getGlobalStat()
>>> pprint(r)
{'downloadSpeed': '23136',
'numActive': '2',
'numStopped': '0',
'numWaiting': '0',
'uploadSpeed': '0'}
aria2.purgeDownloadResult()
This method purges completed/error/removed downloads to free memory. This method
returns OK.
aria2.removeDownloadResult(gid)
This method removes completed/error/removed download denoted by gid from memory.
This method returns OK for success.
The following examples remove the download result of the download
GID#2089b05ecca3d829.
JSON-RPC EXEMPLO M290
>>> import urllib2, json
>>> from pprint import pprint
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
... 'method':'aria2.removeDownloadResult',
... 'params':['2089b05ecca3d829']})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> pprint(json.loads(c.read()))
{u'id': u'qwer', u'jsonrpc': u'2.0', u'result': u'OK'}
XML-RPC EXEMPLO M300
>>> import xmlrpclib
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> s.aria2.removeDownloadResult('2089b05ecca3d829')
'OK'
aria2.getVersion()
This method returns version of the program and the list of enabled features. The
response is of type struct and contains following keys.
version
Version number of the program in string.
enabledFeatures
List of enabled features. Each feature name is of type string.
JSON-RPC EXEMPLO M310
>>> import urllib2, json
>>> from pprint import pprint
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
... 'method':'aria2.getVersion'})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> pprint(json.loads(c.read()))
{u'id': u'qwer',
u'jsonrpc': u'2.0',
u'result': {u'enabledFeatures': [u'Async DNS',
u'BitTorrent',
u'Firefox3 Cookie',
u'GZip',
u'HTTPS',
u'Message Digest',
u'Metalink',
u'XML-RPC'],
u'version': u'1.11.0'}}
XML-RPC EXEMPLO M320
>>> import xmlrpclib
>>> from pprint import pprint
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> r = s.aria2.getVersion()
>>> pprint(r)
{'enabledFeatures': ['Async DNS',
'BitTorrent',
'Firefox3 Cookie',
'GZip',
'HTTPS',
'Message Digest',
'Metalink',
'XML-RPC'],
'version': '1.11.0'}
aria2.getSessionInfo()
This method returns session information. The response is of type struct and
contains following key.
sessionId
Session ID, which is generated each time when aria2 is invoked.
JSON-RPC EXEMPLO M330
>>> import urllib2, json
>>> from pprint import pprint
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
... 'method':'aria2.getSessionInfo'})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> pprint(json.loads(c.read()))
{u'id': u'qwer',
u'jsonrpc': u'2.0',
u'result': {u'sessionId': u'cd6a3bc6a1de28eb5bfa181e5f6b916d44af31a9'}}
XML-RPC EXEMPLO M340
>>> import xmlrpclib
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> s.aria2.getSessionInfo()
{'sessionId': 'cd6a3bc6a1de28eb5bfa181e5f6b916d44af31a9'}
aria2.shutdown()
This method shutdowns aria2. This method returns OK.
aria2.forceShutdown()
This method shutdowns aria2. This method behaves like aria2.shutdown() except that
any actions which takes time such as contacting BitTorrent tracker are skipped.
This method returns OK.
system.multicall(methods)
This methods encapsulates multiple method calls in a single request. methods is of
type array and its element is struct. The struct contains two keys: methodName and
params. methodName is the method name to call and params is array containing
parameters to the method. This method returns array of responses. The element of
array will either be a one-item array containing the return value of each method
call or struct of fault element if an encapsulated method call fails.
In the following examples, we add 2 downloads. First one is http://example.org/file
and second one is file.torrent.
JSON-RPC EXEMPLO M350
>>> import urllib2, json, base64
>>> from pprint import pprint
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
... 'method':'system.multicall',
... 'params':[[{'methodName':'aria2.addUri',
... 'params':[['http://example.org']]},
... {'methodName':'aria2.addTorrent',
... 'params':[base64.b64encode(open('file.torrent').read())]}]]})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> pprint(json.loads(c.read()))
{u'id': u'qwer', u'jsonrpc': u'2.0', u'result': [[u'2089b05ecca3d829'], [u'd2703803b52216d1']]}
JSON-RPC also supports Batch request described in JSON-RPC 2.0 Specification:
>>> jsonreq = json.dumps([{'jsonrpc':'2.0', 'id':'qwer',
... 'method':'aria2.addUri',
... 'params':[['http://example.org']]},
... {'jsonrpc':'2.0', 'id':'asdf',
... 'method':'aria2.addTorrent',
... 'params':[base64.b64encode(open('file.torrent').read())]}])
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> pprint(json.loads(c.read()))
[{u'id': u'qwer', u'jsonrpc': u'2.0', u'result': u'2089b05ecca3d829'},
{u'id': u'asdf', u'jsonrpc': u'2.0', u'result': u'd2703803b52216d1'}]
XML-RPC EXEMPLO M360
>>> import xmlrpclib
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> mc = xmlrpclib.MultiCall(s)
>>> mc.aria2.addUri(['http://example.org/file'])
>>> mc.aria2.addTorrent(xmlrpclib.Binary(open('file.torrent').read()))
>>> r = mc()
>>> tuple(r)
('2089b05ecca3d829', 'd2703803b52216d1')
Tratamento de Erros
Usando JSON-RPC, aria2 retorna objeto JSON que contém código de erro no código e a
mensagem de erro na mensagem.
Usando XML-RPC, aria2 retorna código de falha (faultCode=1) e a mensagem de erro em
(faultString).
Opções
Same options for --input-file list are available. Ver subseção Arquivo de Entrada para
lista completa de opções.
In the option struct, name element is option name(without preceding --) and value element
is argument as string.
EXEMPLO JSON-RPC M370
{'split':'1', 'http-proxy':'http://proxy/'}
EXEMPLO XML-RPC M380
<struct>
<member>
<name>split</name>
<value><string>1</string></value>
</member>
<member>
<name>http-proxy</name>
<value><string>http://proxy/</string></value>
</member>
</struct>
header and index-out option are allowed multiple times in command-line. Since name should
be unique in struct(many XML-RPC library implementation uses hash or dict for struct),
single string is not enough. To overcome this situation, they can take array as value as
well as string.
EXEMPLO JSON-RPC M390
{'header':['Accept-Language: ja', 'Accept-Charset: utf-8']}
EXEMPLO XML-RPC M400
<struct>
<member>
<name>header</name>
<value>
<array>
<data>
<value><string>Accept-Language: ja</string></value>
<value><string>Accept-Charset: utf-8</string></value>
</data>
</array>
</value>
</member>
</struct>
Following example adds a download with 2 options: dir and header. header option has 2
values, so it uses a list:
>>> import xmlrpclib
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> opts = dict(dir='/tmp',
... header=['Accept-Language: ja',
... 'Accept-Charset: utf-8'])
>>> s.aria2.addUri(['http://example.org/file'], opts)
'1'
JSON-RPC usando HTTP GET
The JSON-RPC interface also supports request via HTTP GET. The encoding scheme in GET
parameters is based on JSON-RPC over HTTP Specification [2008-1-15(RC1)]. The encoding of
GET parameters are follows:
/jsonrpc?method=METHOD_NAME&id=ID¶ms=BASE64_ENCODED_PARAMS
The method and id are always treated as JSON string and their encoding must be UTF-8.
For example, The encoded string of aria2.tellStatus('2089b05ecca3d829') with id='foo'
looks like this:
/jsonrpc?method=aria2.tellStatus&id=foo¶ms=WyIyMDg5YjA1ZWNjYTNkODI5Il0%3D
The params parameter is Base64-encoded JSON array which usually appears in params
attribute in JSON-RPC request object. In the above example, the params is
["2089b05ecca3d829"], therefore:
["2089b05ecca3d829"] --(Base64)--> WyIyMDg5YjA1ZWNjYTNkODI5Il0=
--(Percent Encode)--> WyIyMDg5YjA1ZWNjYTNkODI5Il0%3D
The JSON-RPC interface supports JSONP. You can specify the callback function in
jsoncallback parameter:
/jsonrpc?method=aria2.tellStatus&id=foo¶ms=WyIyMDg5YjA1ZWNjYTNkODI5Il0%3D&jsoncallback=cb
For Batch request, method and id parameter must not be specified. Whole request must be
specified in params parameter. For example, Batch request:
[{'jsonrpc':'2.0', 'id':'qwer', 'method':'aria2.getVersion'},
{'jsonrpc':'2.0', 'id':'asdf', 'method':'aria2.tellActive'}]
will be encoded like this:
/jsonrpc?params=W3sianNvbnJwYyI6ICIyLjAiLCAiaWQiOiAicXdlciIsICJtZXRob2QiOiAiYXJpYTIuZ2V0VmVyc2lvbiJ9LCB7Impzb25ycGMiOiAiMi4wIiwgImlkIjogImFzZGYiLCAibWV0aG9kIjogImFyaWEyLnRlbGxBY3RpdmUifV0%3D
JSON-RPC sobre WebSocket
JSON-RPC sobre WebSocket utiliza o mesmo método de assinatura e resposta do formato
JSON-RPC sobre HTTP. O WebSocket suportado é da versão 13 o qual é detalhado na RFC 6455.
Para enviar uma requisição RPC para um servidor RPC, enviar strings serializadas JSON num
frame Text. A resposta do servidor RPC será entregue também em um frame Text.
O servidor RPC ira enviar a notificação ao cliente. A notificação é unidirecional,
portanto o cliente que receber a notificação não pode responde-la. Esse método de
assinatura de notificação é muito usual mas não provê uma identificação de chave. Os
valores associados pelos parâmetros chave são os dados que a notificação porta. O formato
desses valores variam dependendo do método de notificação. Os seguintes métodos de
notificação são definidos:
aria2.onDownloadStart(event)
Essa notificação será enviada quando e se o download for iniciado. event é o tipo
de estrutura e pode conter as seguintes chaves: O formato do valor é string.
gid GID do download.
aria2.onDownloadPause(event)
Esta notificação será enviada se o download for pausado. event tem a mesma
estrutura do argumento event do método da função aria2.onDownloadStart().
aria2.onDownloadStop(event)
Essa notificação será enviada se o download for interrompido pelo usuário. event
tem a mesma estrutura do argumento event do método da função
aria2.onDownloadStart().
aria2.onDownloadComplete(event)
Esta notificação será enviada quando o download for completado. Para downloads
BitTorrent, esta notificação será enviada quando for completado e o (seed)
terminar. O event tem a mesma estrutura do event do método da função
aria2.onDownloadStart().
aria2.onDownloadError(event)
Esta notificação será enviada se o download for interrompido por causa de um erro.
O event tem a mesma estrutura do event do método da função aria2.onDownloadStart().
aria2.onBtDownloadComplete(event)
Esta notificação será enviada se o download for completado para o BitTorrent (mas o
seeding pode não ter sido concluído). O event tem a mesma estrutura do event do
método da função aria2.onDownloadStart().
Exemplo Cliente XML-RPC Ruby
O seguinte script Ruby script adiciona http://localhost/aria2.tar.bz2 em aria2c no
servidor em localhost com a opção --dir=/downloads e imprime a resposta do processamento:
#!/usr/bin/env ruby
require 'xmlrpc/client'
require 'pp'
client=XMLRPC::Client.new2("http://localhost:6800/rpc")
options={ "dir" => "/downloads" }
result=client.call("aria2.addUri", [ "http://localhost/aria2.tar.bz2" ], options)
pp result
Se você usa Python, pode usar xmlrpclib (em Python3.x, use xmlrpc.client) para interagir
com aria2:
import xmlrpclib
from pprint import pprint
s = xmlrpclib.ServerProxy("http://localhost:6800/rpc")
r = s.aria2.addUri(["http://localhost/aria2.tar.bz2"], {"dir":"/downloads"})
pprint(r)
DIVERSOS
Mensagens na Console
Enquanto executa o download de arquivos, aria2 imprime mensagens na console para mostrar o
progresso dos downloads. Um exemplo abaixo:
[#1 SIZE:400.0KiB/33.2MiB(1%) CN:1 SPD:115.7KiBs ETA:4m51s]
Entenda o que estes números e strings significam.
#N N significa GID, o qual é um ID único para cada download.
SIZE Tamanho Total e Tamanho em bytes. Se a --select-file é usada, será exibida a
somatória do tamanho do arquivo.
SEEDING
Taxa compartilhamento ratio. O cliente está funcionando. Após término do download
do BitTorrent, SIZE será substituído por SEEDING.
CN Número de conexões que o cliente estabeleceu.
SEED O número de seeders ao qual o cliente está conectado.
SPD Velocidade do download.
UP Velocidade e número de bytes transmitidos upload.
ETA Tempo previsto para conclusão.
TOTAL SPD
A soma das velocidades de download para todos downloads paralelos.
Quando aria2 está alocando o espaço para arquivo ou validando o checksum, adicionalmente
exibirá o progresso:
FileAlloc
GID, tamanho alocado e total em bytes.
Checksum
GID, tamanho validado e total em bytes.
EXEMPLOS DOWNLOAD HTTP / FTP
Download Segmentado HTTP/FTP
Download de arquivo
$ aria2c "http://servidor/arquivo.zip"
NOTA:
Para parar o download, pressione Ctrl-C. Posteriormente pode ser retomado o mesmo
download no mesmo diretório. Podem ser modificadas as URIs pois elas apontam para o
mesmo arquivo.
Download de arquivo de 2 servidores HTTP diferentes
$ aria2c "http://servidor/arquivo.zip" "http://espelhobrasil/arquivo.zip"
Download de arquivo do mesmo servidor HTTP usando 2 conexões
$ aria2c -x2 -k1M "http://servidorbrasil/arquivo.zip"
Download de arquivo de servidor HTTP e FTP
$ aria2c "http://svrbrasil/arquivo.zip" "ftp://servebr/arquivo.zip"
Download arquivos especificados num arquivo txt concomitantemente
$ aria2c -i arquivo.txt -j2
NOTA:
-j especifica número de downloads paralelos.
Usando proxy
Para HTTP:
$ aria2c --http-proxy="http://svrproxy:8080" "http://servidor/arquivo"
$ aria2c --http-proxy="http://svrproxy:8080"
--no-proxy="localhost,127.0.0.1,192.168.0.0/16" "http://servidor/arquivo"
a máscara de rede /16 quer dizer que para toda a rede 192.168 também não
será usado o servidor proxy
Para FTP:
$ aria2c --ftp-proxy="http://svrproxy:8080" "ftp://servidor/arquivo"
NOTA:
Ver --http-proxy, --https-proxy, --ftp-proxy, --all-proxy e --no-proxy para detalhes.
Proxy pode ser especificado nas variáveis de ambiente. Ver seção VARIÁVEIS DE AMBIENTE
.
Proxy com autenticação / autorização
$ aria2c --http-proxy="http://usuário:senha@svrproxy:8080"
"http://servidor/arquivo"
$ aria2c --http-proxy="http://svrproxy:8080"
--http-proxy-user="usuário" --http-proxy-passwd="senha"
"http://servidor/arquivo"
Download Metalink
Download arquivos com Metalink remoto
$ aria2c --follow-metalink=mem "http://servidor/arquivo.metalink"
Download arquivos com Metalink local
$ aria2c -p --lowest-speed-limit=4000 arquivo.metalink
NOTA:
Para parar o download, pressione Ctrl-C. A transferência pode ser retomada executando
aria2c com o mesmo argumento no mesmo diretório
Download diversos arquivos Metalink local
$ aria2c -j2 arquivo1.metalink arquivo2.metalink
Download só arquivos selecionados usando index
$ aria2c --select-file=1-4,8 arquivo.metalink
NOTA:
O index é exibido na console usando opção -S.
Download um arquivo usando Metalink local com preferência do usuário
$ aria2c --metalink-location=pt,us --metalink-version=1.1 --metalink-language=pt-BR arquivo.metalink
Download BitTorrent
Download arquivos de BitTorrent remotos
$ aria2c --follow-torrent=mem "http://servidortorrent/arquivo.torrent"
Download usando arquivo torrent local
$ aria2c --max-upload-limit=40K arquivo.torrent
NOTA:
--max-upload-limit especifica taxa máxima de transmissão (upload).
NOTA:
Para parar o download, pressione Ctrl-C. A transferência pode ser retomada ao executar
aria2c com os mesmos argumentos no mesmo diretório.
Download usando URI BitTorrent Magnet
$ aria2c "magnet:?xt=urn:btih:248D0A1CD08284299DE78D5C1ED359BB46717D8C&dn=aria2"
NOTA:
Lembre-se inserir delimitadores na URI BitTorrent Magnet, pois ela inclui & que tem
significado de parâmetro. Utilizar apóstrofo(') ou aspas(").
Download 2 torrents
$ aria2c -j2 arquivo1.torrent arquivo2.torrent
Download um arquivo usando torrent e servidor HTTP/FTP
$ aria2c -T arqfile.torrent "http://serv1/arqfile" "ftp://svr2/arqfile"
NOTA:
Download de arquivos múltiplos torrent com HTTP e FTP não é suportado.
Download arquivos selecionados usando index(chamado download seletivo )
$ aria2c --select-file=1-4,8 arquivo.torrent
NOTA:
O index é exibido na console usando-se a opção -S.
Especificar arquivo saída
Para especificar arquivo de saída em Downloads de BitTorrent, faz-se necessário conhecer o
index do arquivo no torrent usando a opção --show-files. Por exemplo, a saída exibirá
algo como:
idx|path/length
===+======================
1|dist/base-2.6.18.iso
|99.9MiB
---+----------------------
2|dist/driver-2.6.18.iso
|169.0MiB
---+----------------------
Para salvar 'dist/base-2.6.18.iso' em '/tmp/meudir/base.iso' e 'dist/driver-2.6.18.iso' em
'/tmp/dir/driver.iso', use o seguinte comando:
$ aria2c --dir=/tmp --index-out=1=meudir/base.iso --index-out=2=dir/driver.iso arquivo.torrent
Modificar porta escuta para peer de entrada
$ aria2c --listen-port=7000-7001,8000 arquivo.torrent
NOTA:
Já que aria2 não configura o firewall ou porta de roteamento para portas de
encaminhamento, isto deve ser explicitado manualmente por você.
Especificar condição para para o programa torrent após término do download
$ aria2c --seed-time=120 --seed-ratio=1.0 arquivo.torrent
NOTA:
No exemplo acima, o programa termina após transcorrer 120 minutos após término do
download ou taxa chegar a 1.0.
Controlar velocidade upload Torrent
$ aria2c --max-upload-limit=100K arquivo.torrent
Habilitar IPv4 DHT
$ aria2c --enable-dht --dht-listen-port=6881 arquivo.torrent
NOTA:
DHT utiliza a porta udp, como o aria2 não configura firewall nem porta de roteamento ou
forwarding, por favor executar estas configurações manualmente.
Habilitar IPv6 DHT
$ aria2c --enable-dht6 --dht-listen-port=6881 --dht-listen-addr6=YOUR_GLOBAL_UNICAST_IPV6_ADDR --enable-async-dns6
NOTA:
Se aria2c não foi compilado com c-ares, a opção --enable-async-dns6 não é necessária.
aria2 compartilha a mesma porta ente IPv4 e IPv6 DHT.
Adicionar e remover rastreador URI
Remover todos os rastreadores (tracker) das URIs descritas no arquivo.torrent utilize
http://tracker1/announce e http://tracker2/announce
$ aria2c --bt-exclude-tracker="*" --bt-tracker="http://tracker1/announce,http://tracker2/announce" file.torrent
Funcionalidades avançadas HTTP
Carregar cookies
$ aria2c --load-cookies=cookies.txt "http://servidor/arquivo.zip"
NOTA:
Podem ser utilizados sem nenhuma modificação coookies dos navegadores: Firefox /
Mozilla / Chromium.
Continuar download iniciado por navegadores ou outros programas
Quando desejar continuar ou retomar um download cujo processamento foi interrompido,
seja em navegador ou qualquer outro programa utilize o aria2c para retomar este
download do ponto onde parou.
$ aria2c -c -s2 "http://servidor/arquivodedownloadparcial.zip"
Autenticação certificado para Cliente SSL/TLS
$ aria2c --certificate=/path/para/mycert.pem --private-key=/path/para/mykey.pem https://servidor/arquivo
NOTA:
O arquivo especificado na opção --private-key não pode estar criptografado. O
comportamento do processo fica indefinido quando o arquivo estiver criptografado.
Verificar peer em SSL/TLS usando certificados CA
$ aria2c --ca-certificate=/path/para/ca-certificates.crt
--check-certificate https://servidor/arquivo
Funcionalidades avançadas adicionais
Controlar velocidade de download
Quando for necessário o controle da utilização da banda disponível, pode ser utilizado a
opção abaixo. Atenção o sufixo K ou M deve ser em letra maiúscula.
$ aria2c --max-download-limit=100K arquivo.metalink
Reparar um download danificado
$ aria2c -V arquivo.metalink
NOTA:
Reparar downloads danificados pode ser mais eficiente usando BitTorrent ou Metalink com
a opção verificação (checksums).
Desconectar conexão se a velocidade download for menor que um valor
$ aria2c --lowest-speed-limit=10K file.metalink
Suporte a URI parametrizada
A URI pode ser especificada como partes de um conjunto:
$ aria2c -P "http://{svr1,svr2,svr3}/arquivo.iso"
Também podem ser especificados sequencias de intervalos:
$ aria2c -Z -P "http://servidor/imagem[000-100].png"
NOTA:
-Z opção requerida para que todas URIs não apontem para o mesmo arquivo, como declarado
no código acima.
Especificar incrementos para contador:
$ aria2c -Z -P "http://servidor/imagem[A-Z:2].png"
Verificar validação checksum
$ aria2c --checksum=sha-1=0192ba11326fe2298c8cb4de616f4d4140213837
http://dobrasil.org/arquivo
Download Paralelo de uma quantidade arbitrária de URI, Metalink ou Torrent
$ aria2c -j3 -Z "http://servidor/arquivo1" arquivo2.torrent arq3.metalink
BitTorrent Criptografado
Criptografar todo conjunto usando ARC4:
$ aria2c --bt-min-crypto-level=arc4 --bt-require-crypto=true arquivo.torrent
VER TAMBÉM
Site do Projeto aria2: http://aria2.sourceforge.net/
Wiki aria2: http://sourceforge.net/apps/trac/aria2/wiki
Site do Projeto Metalink: http://www.metalinker.org/
Descrição do Formato Download Metalink: RFC 5854
COPYRIGHT
Copyright (C) 2006, 2014 Tatsuhiro Tsujikawa Tradução para Português do Brasil 2013,
Gilberto dos Santos Alves utilizando editor kate e gedit no Debian squeeze 6.0.6 novembro
de 2012 revisado em março de 2013 usando editor kate e gedit no ubuntu 12.04 LTS
Esse programa é software livre; pode ser redistribuido e/ou modificado sob os termos da
Licença GNU General Public License como publicada por Free Software Foundation
www.fsf.org; versão 2 da Licença, ou qualquer versão mais recente, qualquer que seja sua
escolha.
Este programa é distribuído na intenção de ser útil, mas SEM NENHUMA GARANTIA; sem
qualquer garantia implícita de ser COMERCIALIZÁVEL ou para PROPÓSITO ESPECÍFICO. Consulte
a Linceça GNU Genérica para mais detalhes.
Você precisa receber uma cópia da Licença Pública GNU Genérica junto com este programa;
caso não tenha, escrevá para Free Software Foundation, Inc., 51 Franklin Street, Fifth
Floor, Boston, MA 02110-1301 USA
Adicionalmente, como uma exceção especial, os detentores do direito autoral autorizam a
permissão para compilar programas que possuem ligação com parte do código com a biblioteca
OpenSSL sob certas condições como descritas em cada arquivo fonte e autorizam a
distribuição das das combinações das ligações incluindo ambas. Devem ser obedecidos todos
os detalhes da Licença Pública GNU Genérica em relação a OpenSSL. Caso haja modificação
nos arquivos com esta exceção deverá ser extendida esta exceção para as versões
modificadas dos arquivos, mas isto não é obrigatório. Se não houver esta intenção exclua
esta declaração de exceção da sua versão. Caso sejam excluídas as declarações de todos os
arquivos fontes, exclua também esta declaração daqui.
Anotação sobre divergência entre Manual e o aria2:
Esta página de manual pode não necessariamente conter a última informação. Caso haja
discrepância entre alguma informação do manual e o aria2, por favor refira-se a versão em
inglês resultante do comando man aria2c
COPYRIGHT
2013, Tatsuhiro Tsujikawa