Dannex Download Manager
  1. Início
  2. Ajuda
  3. Linha de comando e automação

Linha de comando e automação

O DDM pode ser executado sem sua janela de três maneiras:

  • A própria linha de comando do aplicativo, os mesmos parâmetros do IDM: entregue um download ao aplicativo em execução a partir de um script, um arquivo em lote ou outro programa.
  • dannexdownloadmanager-cli, uma ferramenta de linha de comando separada: baixar arquivos, vídeos e torrents pelo terminal, com indicador de progresso e sem abrir o aplicativo.
  • A API de automação: outros programas listam os downloads do aplicativo em execução (como JSON) e os pausam, iniciam, removem ou excluem, por meio de um canal local protegido por token. Assistentes de IA o usam através do servidor MCP do DDM: consulte Assistentes de IA.

Para executar o aplicativo inteiro sem uma janela, em um servidor doméstico ou NAS, consulte Executar o DDM em um servidor (dannexdownloadmanager --headless); para controlá-lo a partir de um telefone, Controlar o DDM do seu telefone.

Os exemplos usam caminhos do Windows; no macOS e Linux, os programas têm os mesmos nomes sem .exe.

A linha de comando do aplicativo

dannexdownloadmanager.exe /d URL [/p folder] [/f name] [/a] [/n] [/s]
Parâmetro O que faz
/d URL O endereço para baixar.
/p folder Salve-o nesta pasta (caso contrário, a pasta da categoria em Opções → Salvar em).
/f name Salve-o com este nome.
/a Adicione-o à fila de download principal sem iniciá-lo.
/n Silencioso: nenhuma janela de Informações do Arquivo de Download, o download começa (ou é enfileirado, com /a) imediatamente.
/s Inicie a fila de download principal.
/exit Salve e feche o aplicativo em execução (o instalador o usa antes de uma atualização).
/startup Iniciar na área de notificação, com a janela oculta: é assim que a opção Iniciar o Dannex Download Manager na inicialização inicia o DDM quando você faz login. Onde a área de notificação não mostra o ícone do DDM (alguns desktops Linux), o DDM inicia minimizado. Um DDM já em execução permanece como está.
um arquivo .torrent ou link magnet: Abra-o em Adicionar torrent (o que o Windows passa quando o DDM abre torrents).

Os parâmetros podem começar com / ou -, em qualquer caso. Se o DDM estiver em execução, o comando vai para ele; se não, o DDM inicia e o executa. Por exemplo:

dannexdownloadmanager.exe /d https://example.com/files/report.pdf /p D:\Reports /n
dannexdownloadmanager.exe /d https://example.com/big.iso /a
dannexdownloadmanager.exe /s

dannexdownloadmanager-cli

Ele acompanha todos os downloads do DDM e fica ao lado do aplicativo (o instalador o coloca na pasta do DDM). Funciona de forma independente: o aplicativo não precisa estar em execução, exceto para status e api.

Comando O que faz
get URL [-o folder\|file] [-c connections] [-H "Header: value"]... [--checksum hash] [--dns choice] [--adapter name] Baixa um arquivo com até 8 conexões (-c, de 1 a 128), mostrando o progresso. Ctrl+C pausa; resume continua. --checksum verifica o arquivo finalizado: MD5 hexadecimal, SHA-1, SHA-256, SHA-512 ou CRC32, opcionalmente nomeado (sha256:…). --dns escolhe o DNS: system (o padrão); um serviço e como solicitá-lo, cloudflare-https, quad9-tls, google-plain, adguard-https, nextdns-tls; endereços de servidores DNS, 9.9.9.9,149.112.112.112; ou um endereço DNS-over-HTTPS. Nunca retorna ao DNS do sistema. --adapter envia cada conexão por um adaptador de rede, pelo seu nome (Ethernet, wg0) ou um de seus endereços; quando não está conectado, nada é enviado e o download falha. Um link de um host de arquivo que uma de suas contas de desbridamento (Opções → Contas) suporta passa por essa conta, como no aplicativo, e get diz through Real-Debrid; --direct baixa o próprio endereço (Contas de serviço de desbridamento).
resume file.mdm.json [-c connections] [-H ...] [--direct] Continua um download pausado ou interrompido a partir do arquivo .mdm.json ao lado dele. Através de uma conta de desbridamento, como get: o serviço fornece um novo link quando o antigo expirou; --direct continua a partir do próprio endereço.
install-gallery-dl Instala ou atualiza o gallery-dl, para galerias de imagens: a lista de somas de verificação é verificada com a chave de assinatura do autor, o programa com essa lista (Windows e Linux x86-64; em outros sistemas, instale você mesmo).
gallery-get URL [-o folder] [--limit N] [-c N] [--adapter name] Baixa as imagens de uma galeria (uma categoria do Wikimedia Commons, um álbum do Flickr, ...) para uma pasta com o nome dela dentro de -o: o gallery-dl as lista, o downloader do DDM as traz, -c de uma vez (8 por padrão, como as conexões de get); --limit pega no máximo essa quantidade, as primeiras que o site lista. Iniciado de novo, busca só as novas. --adapter envia as conexões dele, e as do gallery-dl, por um adaptador de rede, como em get.
video-info URL Quais vídeos uma página contém (YouTube, Vimeo, ...) e as qualidades disponíveis.
playlist-info URL [--from N] [--count N] Vídeos de uma playlist ou canal, um por linha, na ordem em que aparecem na lista: posição, duração, título e endereço.
playlist-get URL [-f selector] [-o folder] [-c pieces] [--from N] [--count N] Baixa os vídeos de uma playlist ou canal um após o outro, em uma pasta com o nome da lista dentro de -o. -f é uma qualidade para todos, como em video-get (por padrão, a melhor de cada vídeo; bv*[height<=720]+ba/b[height<=720] = até 720p; ba = o som original; mp3:320, opus:, flac: como em video-get). -c como em video-get.
video-get URL [-f selector] [-o folder] [-c pieces] [--subs langs] [--auto-subs] [--embed-subs] [--adapter name] Baixar um vídeo; -f usa um seletor de qualidade de video-info (b = o melhor arquivo único; ba = apenas o áudio como está no site, sem conversão; mp3:320, mp3:256, mp3:192 ou mp3:128 = o áudio como MP3 nessa taxa de bits, mp3:0 na melhor taxa variável; opus: = como Opus; flac: = como FLAC, sem perdas, mas não melhor que o áudio do site; as conversões precisam de ffmpeg). -c: o próprio gerenciador de downloads do DDM baixa cada stream que o yt-dlp encontra usando essa quantidade de conexões (8 por padrão, de 1 a 128), e um stream em partes (HLS, DASH) essa quantidade de partes de uma vez. --subs salva legendas ao lado: códigos de idioma de video-info (en,fr), ou all para todas as que o remetente forneceu; --auto-subs usa as legendas automáticas do site; --embed-subs as insere no vídeo (precisa de ffmpeg, MP4 ou MKV). --adapter envia as conexões dos downloads, e as do yt-dlp (e ffmpeg), por um adaptador de rede, como para get; quando não está conectado, nada inicia.
install-ytdlp, install-ffmpeg Instalar ou atualizar os componentes necessários para baixar vídeos: yt-dlp (verificado com a chave de assinatura) e ffmpeg (no Windows; no macOS e no Linux, o DDM usa o ffmpeg do sistema).
torrent-info SOURCE Nome, arquivos (numerados) e tamanho de um torrent; SOURCE é um link magnet ou um arquivo .torrent.
torrent-get SOURCE [-o folder] [--files 0,2] [--use-existing] Baixar um torrent ou apenas alguns de seus arquivos. Se alguns arquivos já estiverem na pasta, o download é interrompido e os nomes desses arquivos são exibidos; --use-existing usa esses arquivos (os que correspondem são mantidos, e os demais são baixados).
torrent-create PATH -o file.torrent Criar um .torrent de um arquivo ou pasta (os pares o encontram pela DHT).
status Os downloads do aplicativo em execução, em JSON, com seus IDs (a API de automação deve estar ativada).
pause ID..., start ID... Pausar downloads em andamento ou iniciar (retomar) downloads parados, na fila ou com falha no aplicativo em execução.
remove ID..., delete ID... Remove downloads da lista do aplicativo em execução: remove mantém os arquivos, delete também os apaga. Um download em andamento é pausado primeiro (pause).
api on, api off Ativa ou desativa a API de automação do aplicativo em execução.

dannexdownloadmanager-cli help <command>mostra todas as opções. Um comando que falha (o aplicativo não está em execução, ele responde com um erro, um download é interrompido) sai com o código 1. Por exemplo:

dannexdownloadmanager-cli get https://example.com/big.iso -o D:\Downloads -c 16 --checksum sha256:9f86d0…
dannexdownloadmanager-cli video-get "https://www.youtube.com/watch?v=aqz-KE-bpKQ" -f "b[height=720]"
dannexdownloadmanager-cli torrent-get "magnet:?xt=urn:btih:…" --files 0

JSON para scripts e programas

Com --json (antes ou depois do comando), cada comando imprime JSON em vez de texto, um objeto por linha, para scripts e agentes de IA lerem:

Comando Imprime
get, resume {"event": "through", "service"}primeiro quando o download passa por uma conta de desbridamento, depois uma linha {"event": "progress", "downloaded", "size", "speed", "connections", "segments"} a cada meio segundo, depois {"event": "done", "path", "size", "seconds"}, ou {"event": "paused", "state"} após Ctrl+C (state é o arquivo que resume usa).
video-get {"event": "progress", "downloaded", "size", "speed"}linhas, então {"event": "done", "path", "subtitles", "subtitle_problems"}: os arquivos de legenda salvos ao lado, e os idiomas que o site recusou ({"code", "name", "reason", "beside"}; beside: eles vieram em uma segunda tentativa, ao lado do vídeo em vez de dentro dele).
torrent-get {"event": "progress", "phase", "downloaded", "size", "speed", "peers", "peers_seen"}linhas, depois {"event": "done", "path", "size"}, ou {"event": "stopped", "downloaded", "seconds"} com --seconds.
video-info {"title", "choices": [{"label", "format", "size"}], "subtitles": [{"code", "name", "automatic"}]}; o format de uma escolha é o que video-get -f pega, o code de uma legenda é o que --subs pega.
torrent-info {"name", "info_hash", "size", "files": [{"index", "size", "path"}]}.
torrent-create {"info_hash", "path"}.
install-ytdlp, install-ffmpeg {"tool", "version", "path"}.
status, pause, start, remove, delete,api A resposta do aplicativo, que já é JSON (veja abaixo).

Os tamanhos são em bytes (null enquanto desconhecido), as velocidades em bytes por segundo. Uma falha imprime {"error": "…"} e sai com o código 1. Por exemplo:

dannexdownloadmanager-cli --json get https://example.com/big.iso -o D:\Downloads
{"event":"progress","downloaded":4194304,"size":1073741824,"speed":52428800,"connections":8,"segments":8}
…
{"event":"done","path":"D:\\Downloads\\big.iso","size":1073741824,"seconds":20.4}

A API de automação

Outros programas podem perguntar ao aplicativo em execução o que ele está baixando e pausar, iniciar, remover ou excluir downloads. A API está desativada por padrão; ative-a com dannexdownloadmanager-cli api on (e desative-a com api off).

Como um programa se comunica com o DDM

  1. Enquanto executa, o DDM escuta em uma porta de 127.0.0.1 (somente neste computador) e escreve a porta e um token secreto em ipc.json em sua pasta de dados: - Windows: %APPDATA%\dannexdownloadmanager\ipc.json - macOS: ~/Library/Application Support/dannexdownloadmanager/ipc.json - Linux: ~/.local/share/dannexdownloadmanager/ipc.json - Uma cópia portátil: data\ipc.json ao lado do programa.

O token muda a cada inicialização; somente programas que podem ler sua pasta de dados (a sua) podem usá-lo. 2. Conecte-se a essa porta e envie uma linha de JSON: o token e os campos do comando, por exemplo {"token": "<token>", "query": "list"}. 3. O DDM responde com uma linha: ok para um comando, ou um objeto JSON para uma pergunta.

O que ele entende

Campos (além de token) Resposta
{"query": "list"} Cada download e a velocidade total: {"downloads": [{"id", "file", "url", "path", "status", "size", "downloaded", "speed", "added", "category", "error"}], "speed": bytes per second, "queues": [{"name", "running", "ids"}], "categories": [{"key", "name"}], "free": bytes}. status é Queued, Downloading, Stopped, Complete ou Error; size é null enquanto desconhecido; error (por que falhou) só existe para um download em Error; category é o key de uma categoria; free é o espaço livre onde os downloads são salvos (null quando desconhecido). Somente enquanto a API estiver ativada.
{"action": "pause", "ids": [3, 4]} Age sobre downloads pelo id: "pause", "start", "remove" (arquivo mantido), "delete" (arquivo também excluído) ou "folder" (mostra o arquivo na pasta, como Abrir pasta faz). Responde {"done": [3], "skipped": [{"id": 4, "why": "not running"}]}; um download em andamento deve ser pausado antes de ser removido ou excluído. Só enquanto a API está ativada.
{"action": "start_queue", "queue": "Main download queue"} Inicia (ou com "stop_queue", para) a fila com esse nome (um nome do queues da lista). Responde {"done": [], "skipped": []}, ou {"error": …, "code": "unknown-queue"}. Somente enquanto a API estiver ativada.
{"api": true} / {"api": false} Ativa ou desativa a API: {"api": true}.
{"url": "https://…", "dir": "D:\\Files", "name": "a.zip", "silent": true} Adiciona um download, como o /d /p /f /n da linha de comando faz ("later": true é /a); ok. "category" (uma chave do categories da lista) o coloca na pasta dessa categoria em vez daquela que seu tipo escolhe; "queue" (o nome de uma fila) é a fila em que ele espera com "later". Também com a API desativada, como a linha de comando.
{"start_queue": true} Inicia a fila principal de downloads; ok.

Uma pergunta ou ação desconhecida é respondida {"error": "…"}, assim como uma pergunta enquanto a API está desativada (então com "code": "api-off", para programas verificarem: o texto do erro pode mudar). Um token incorreto é respondido denied.

O botão da barra de ferramentas da extensão lista os downloads do DDM com o mesmo list, e pausa, retoma e abre as pastas deles com as mesmas ações, seja qual for a chave da API: o auxiliar dela marca o que pede com "browser": true. Ele não pede mais nada desse modo.

Cada solicitação e resposta é descrita, campo por campo, em um JSON Schema: automation-api.schema.json (também em https://dannex.kavangi.co.ke/automation-api.schema.json). Ele é feito a partir do código com o qual o aplicativo responde, então permanece exato; os programas podem verificar o que enviam e leem em relação a ele, ou gerar seus tipos a partir dele.

Exemplos

PowerShell (Windows):

$ep = Get-Content "$env:APPDATA\dannexdownloadmanager\ipc.json" | ConvertFrom-Json
$client = New-Object Net.Sockets.TcpClient("127.0.0.1", $ep.port)
$stream = $client.GetStream()
$writer = New-Object IO.StreamWriter($stream); $reader = New-Object IO.StreamReader($stream)
$writer.WriteLine((@{ token = $ep.token; query = "list" } | ConvertTo-Json -Compress))
$writer.Flush()
$reader.ReadLine() | ConvertFrom-Json | Select-Object -ExpandProperty downloads | Format-Table file, status, downloaded, size
$client.Close()

Python:

import json, os, socket

ipc = os.path.join(os.environ["APPDATA"], "dannexdownloadmanager", "ipc.json")  # see above elsewhere
ep = json.load(open(ipc))
with socket.create_connection(("127.0.0.1", ep["port"])) as s:
    s.sendall((json.dumps({"token": ep["token"], "query": "list"}) + "\n").encode())
    answer = json.loads(s.makefile().readline())
for d in answer["downloads"]:
    print(d["file"], d["status"], d["downloaded"], d["size"])

Para adicionar um download, envie {"token": "…", "url": "https://example.com/a.zip", "silent": true}.

Gratuito, de código aberto, sem anúncios, sem período de teste.

Baixar Dannex Download Manager