AMULECMD(1) utilitários aMule AMULECMD(1)

amulecmd - Programa baseado em console para controlar o aMule

amulecmd [-h <anfitrião>] [-p <porta>] [-P <senha>] [-f <path>] [-q] [-v] [-l <língua>] { [-w] | [-c <comando>] }

amulecmd [--create-config-from=<path>]

amulecmd [--version]

amulecmd [--help]

amulecmd é um programa baseado em console para rodar o núcleo do aMule sem IGU.

[ -h <anfitrião>, --host=<anfitrião> ]
Anfitrião onde o aMule está rodando (padrão: 127.0.0.1). <anfitrião> pode ser um endereço IP ou um nome de DNS
[ -p <porta>, --port=<porta> ]
Porta do aMule para conexões externas (EC), conforme configurado em Preferências->Controles Remotos (padrão: 4712)
[ -P <senha>, --password=<senha> ]
Senha das Conexões Externas (EC).
[ -f <path>, --config-file=<path> ]
Use o arquivo de configuração dado. O arquivo de configuração padrão é ~/.aMule/remote.conf
[ -q, --quiet ]
Não imprimir qualquer saída para stdout.
[ -v, --verbose ]
Ser verborrágico - mostrar mensagens de debug também.
[ -l <língua>, --locale=<língua> ]
Configura o local do programa (linguagem). Veja a seção NOTAS para a descrição do parâmetro <lang>.
[ -w, --write-config ]
Escrever as opções da linha de comando para o arquivo de configuração e sair
[ -c <commando>, --command=<commando> ]
Executar <command> como se fosse digitado no prompt do amulecmd e sair.
[ --create-config-from=<path> ]
Criar arquivo de configuração baseado em <path>, que precisa apontar para um arquivo válido de configuração do aMule, e então sair.
[ --force-zlib ]
Força compressão ZLIB no link de Conexões Externas independente da localidade IP-discada. Útil quando o lado do servidor for alcançável com um túnel VPN que resolve para um IP de LAN e a heurística iria pular a compressão.
[ --version ]
Mostra o número de versão atual.
[ --help ]
Imprime uma descrição de uso curta.

Todos os comandos são insensíveis a maiúsculas e minúsculas.

Adiciona um link eD2k ou link magnético ao núcleo.

O link eD2k a ser adicionado pode ser:

  • um link de arquivo (ed2k://|file|...), ele será adicionado à fila de download;
  • um link de servidor (ed2k://|server|...), ele será adicionado à lista de servidores;
  • um link de lista de servidores, no qual todos os servidores na lista serão adicionados à lista de servidores.

O link magnético precisa conter o hash eD2k e o tamanho do arquivo.

Cancela o download especificado por <hash> ou <number>. Para pegar o valor, use show.

Conecta à rede.

Isto vai conectar à todas as redes que estiverem habilitadas nas preferências.

Com o parâmetro opcional você pode especificar a que rede conectar. Ao dar um endereço de servidor na forma IP:Porta (onde IP é um endereço IPv4 ou um nome de DNS resolvível) o aMule vai conectar apenas a este servidor.

Desconectar de todas as redes que estiver conectado ou apenas desconectar da rede especificada.

Começar a baixar um arquivo.

O <numero> de um arquivo da última busca tem que ser dado. Exemplo: `download 12' começará a baixar o arquivo com o número 12 da última busca.

Desconecta do amule/amuled e sai de amulecmd.

Pega e mostra um valor de preferência.

Valores disponíveis para <qual>:

Pegar limites de banda.
Pegar preferências de IPFilter.

Imprime uma descrição de uso curta. Se chamado sem parâmetros, mostra a lista dos comandos disponíveis. Se chamado com <command>, mostra uma descrição curta do comando dado.

Pausa o download especificado por <hash> ou <numero>. Para pegar o número use show.

Configura a prioridade de um download especificado por <hash> ou <numero>.

Valores disponíveis para <prioridade>:

Prioridade automática.
Alta prioridade.
Baixa prioridade.
Prioridade normal.

Mostra o progresso de uma busca em andamento.

Um sinônimo para o comando exit.

Recarrega um objeto dado.

Valores disponíveis para <qual>:

Recarrega a lista de arquivos compartilhados.
Recarrega as tabelas de filtragem de IP.

Apaga o log.

Mostra os resultados da última busca.

Retoma o download especificado por <hash> ou <numero>. Para pegar o valor, use show.

Faz uma busca pela <palavra chave> dada. Um tipo de busca e uma palavra chave são mandatórias para fazer isso. Exemplo: `search kad amule' executa uma busca kad por `amule'.

Tipos de busca disponíveis:

Executa uma busca global.
Executa uma busca na rede Kademlia.
Executa uma busca local.

Filtros opcionais podem ser colocado antes, depois ou intercalados com as palavras chaves de busca:

Restringir os resultados ao tipo de arquivo dado.
Restringir os resultados ao tipo específico de extensão. (e.g.  iso, mp3).
Número mínimo de fontes que um resultado tem que reportar.
Menor tamanho de arquivo a ser retornado. Os sufixos usam multiplicadores binários (K = 1024, M = K×1024, G = M×1024); sem sufixos significa bytes.
Maior tamanho de arquivo a ser retornado. Mesmos sufixos que --min-size.

Exemplo: `earch global linux iso --type Iso --min-size 100M' retorna resultados para “linux iso” do tipo de arquivo Iso com no mínimo 100 MiB.

Configura um dado valor de preferência.

Valores disponíveis para <qual>:

Configura limites de banda.
Configura preferências de IPFilter.

Mostra a fila de upload/download, lista de servidores or lista de arquivos compartilhados.

Valores disponíveis para <qual>:

Mostra a fila de download.
Mostra o log.
Mostra a lista de servidores.
Mostra a lista de arquivos compartilhados.
Mostra a lista de upload.

Desliga o núcleo rodando remotamente (amule/amuled). Isto também desligará o cliente modo texto, já que este é inútil sem um núcleo rodando.

Mostra a árvore de estatísticas.

O <numero> opcional na faixa de 0-255 pode ser passado como argumento para este comando, que diz quantas entradas da sub-árvore de versão do cliente deve ser mostrada. Passar 0 ou omitir significa `ilimitado'.

Exemplo: `statistics 5' vai mostrar apenas as 5 versões mais altas para cada tipo de cliente.

Mostrar o estado das conexões, velocidades atuais de upload/download, etc.

Para todas as opções que recebem um valor <path>, se o path não contém uma parte de diretório (i.e. apenas o nome de arquivo), então é considerado estar debaixo do diretório de configuração do aMule, ~/.aMule.

O parâmetro <lang> da opção -l tem a seguinte forma: lang[_LANG][.encoding][@modifier] onde lang é a linguagem principal, LANG é a sub-lingua/território, encoding é o conjunto de caracteres a ser utilizado e modifier permite ao usuário selecionar uma instância específica dos dados de localização dentro de uma única categoria.

Por exemplo, as seguintes strings são válidas:

de
de_DE
de_DE.iso88591
de_DE@euro
de_DE.iso88591@euro

Apesar de todas as strings acima serem aceitas como definições de línguas válidas, encoding e modifier não são utilizados ainda.

Além do formato acima, você pode também especificar nomes completos de linguagens em Inglês - deste modo -l german também é válido e é igual a -l de_DE.

Quando nenhum local está definido, seja na linha de comando ou no arquivo de configuração, a linguagem padrão do sistema será utilizada.

~/.aMule/remote.conf

Tipicamente, amulecmd será inicialmente rodado assim:

amulecmd -h nome do anfitrião -p porta EC -P senha EC -w

ou

amulecmd --create-config-from=/home/username/.aMule/amule.conf

Estes savarão as configurações em $HOME/.aMule/remote.conf, e posteriormente você só precisa digitar:

amulecmd

Claro, você não precisa seguir este exemplo.

Por favor, relate bugs ou em nosso forum (https://github.com/amule-org/amule/discussions), ou em nosso bugtracker (https://github.com/amule-org/amule/issues). Por favor, não relate bugs por e-mail, nem para nossa lista de e-mail, nem diretamente para qualquer membro do time.

aMule e todos os seus utilitários relacionados são distribuídos sob a licença geral pública GNU.

amule(1), amuled(1)

Esta manpage foi escrita por Vollstrecker <amule@vollstreckernet.de>

June 2026 aMuleCmd vGIT