-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

--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:

--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:

--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:

-o, --out=<ARQUIVO>

O nome do arquivo baixado. Quando a opção --force-sequential é utilizada esta opção será ignorada.

NOTA:

$ 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:

--stream-piece-selector=<SELECTOR>

Specify piece selection algorithm used in HTTP e FTP download. A piece is a fixed length segment which is downloaded in parallel in a segmented download. 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

--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:

--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-Encoding: deflate, gzip e faz (inflate) se o servidor remoto responder com Content-Encoding: gzip ou Content-Encoding: deflate. Padrão: false

NOTA:

--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:

--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:

--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.

--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

--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:

-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).

--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:

--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:

--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:

-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.

--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

--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.

--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 the 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:

--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:

--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:

-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.

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.

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.

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.

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.

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.

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.

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.

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:

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:

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.

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.

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.

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')

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.

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().

#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.

FileAlloc

GID, tamanho alocado e total em bytes.

Checksum

GID, tamanho validado e total em bytes.