Dannex Download Manager
  1. Inicio
  2. Ayuda
  3. Línea de comandos y automatización

Línea de comandos y automatización

DDM se puede controlar sin abrir su ventana de tres maneras:

  • La propia línea de comandos de la aplicación, los mismos modificadores que los de IDM: entregar una descarga a la aplicación en ejecución desde un script, un archivo por lotes u otro programa.
  • dannexdownloadmanager-cli, una herramienta de línea de comandos independiente: descargar archivos, vídeos y torrents desde un terminal, con una barra de progreso y sin abrir la aplicación.
  • La API de automatización: otros programas listan las descargas de la aplicación en ejecución (como JSON) y las pausan, inician, eliminan o borran, a través de un canal local protegido por token. Los asistentes de IA lo usan a través del servidor MCP de DDM: consulta Asistentes de IA.

Para ejecutar la aplicación completa sin ventana, en un servidor doméstico o un NAS, consulta Ejecutar DDM en un servidor (dannexdownloadmanager --headless); para controlarla desde un teléfono, Controlar DDM desde tu teléfono.

Los ejemplos usan rutas de Windows; en macOS y Linux los programas tienen los mismos nombres sin .exe.

La línea de comandos de la aplicación

dannexdownloadmanager.exe /d URL [/p folder] [/f name] [/a] [/n] [/s]
Modificador Qué hace
/d URL La dirección desde la que descargar.
/p folder Guardar el archivo en esta carpeta (si no se indica, se usará la carpeta de la categoría de Opciones → Guardar en).
/f name Guardarlo con este nombre.
/a Añadirlo a la cola de descarga principal sin iniciarlo.
/n Silencioso: sin ventana de Información del archivo de descarga, la descarga comienza (o se pone en cola, con /a) de inmediato.
/s Iniciar la cola de descarga principal.
/exit Guardar y cerrar la aplicación en ejecución (el instalador lo usa antes de una actualización).
/startup Iniciar en el área de notificación, con la ventana oculta: así es como Iniciar Dannex Download Manager al arrancar inicia DDM cuando inicias sesión. Si no hay un área de notificación que muestre el icono de DDM (algunos escritorios Linux), DDM se inicia minimizado. Si DDM ya está en ejecución, se mantiene como está.
un archivo .torrent o un enlace magnet: Abrirlo en Añadir torrent (lo que Windows pasa cuando DDM abre archivos torrent).

Los modificadores pueden empezar con / o -, en cualquier caso. Si DDM se está ejecutando, el comando va a él; si no, DDM se inicia y lo ejecuta. Por ejemplo:

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

Viene con cada descarga de DDM, junto a la aplicación (el instalador lo pone en la carpeta de DDM). Funciona por sí solo: la aplicación no necesita ejecutarse, excepto para status y api.

Comando Qué hace
get URL [-o folder\|file] [-c connections] [-H "Header: value"]... [--checksum hash] [--dns choice] [--adapter name] Descargar un archivo con hasta 8 conexiones (-c, de 1 a 128) y mostrar el progreso. Ctrl+C pausa la descarga; resume la reanuda. --checksum comprueba el archivo descargado con una suma de comprobación hexadecimal: MD5, SHA-1, SHA-256, SHA-512 o CRC32, con un nombre opcional (sha256:…). --dns permite elegir el DNS: system (el predeterminado); un servicio y cómo consultarlo, cloudflare-https, quad9-tls, google-plain, adguard-https, nextdns-tls; las direcciones de servidores DNS, 9.9.9.9,149.112.112.112; o una dirección DNS-over-HTTPS. Nunca recurre al DNS del sistema. --adapter envía cada conexión a través de un adaptador de red, identificado por su nombre (Ethernet, wg0) o por una de sus direcciones; si no está conectado, no se envía nada y la descarga falla. Los enlaces de servidores de archivos compatibles con una de tus cuentas de debrid (Opciones → Cuentas) se descargan a través de esa cuenta, como en la aplicación, y get indica through Real-Debrid; --direct descarga la dirección directamente (Cuentas de servicio de debrid).
resume file.mdm.json [-c connections] [-H ...] [--direct] Reanudar una descarga pausada o interrumpida desde el archivo .mdm.json que está a su lado. Con una cuenta de debrid, funciona como get: si el enlace anterior ha caducado, el servicio proporciona uno nuevo; --direct reanuda la descarga desde la propia dirección.
install-gallery-dl Instalar o actualizar gallery-dl, para descargar galerías de imágenes. La lista de sumas de comprobación se verifica con la clave de firma de su autor y el programa, con esa lista (Windows y Linux x86-64; en otros sistemas, hay que instalarlo manualmente).
gallery-get URL [-o folder] [--limit N] [-c N] [--adapter name] Descarga las imágenes de una galería (una categoría de Wikimedia Commons, un álbum de Flickr, ...) en una carpeta con su nombre dentro de -o: gallery-dl las enumera, el descargador de DDM las trae, -c a la vez (8 por defecto, como las conexiones de get); --limit toma como máximo ese número, las primeras que lista el sitio. Si se inicia de nuevo, solo descarga las nuevas. --adapter envía sus conexiones, y las de gallery-dl, por un solo adaptador de red, como en get.
video-info URL Qué vídeo contiene una página (YouTube, Vimeo, ...) y qué calidades se pueden elegir.
playlist-info URL [--from N] [--count N] Los vídeos de una lista de reproducción o un canal, uno por línea y en el orden en que aparecen: posición, duración, título y dirección.
playlist-get URL [-f selector] [-o folder] [-c pieces] [--from N] [--count N] Descarga los vídeos de una lista de reproducción o canal uno tras otro, en una carpeta con el nombre de la lista dentro de -o. -f es una calidad para todos, como en video-get (por defecto, la mejor de cada vídeo; bv*[height<=720]+ba/b[height<=720] = hasta 720p; ba = el sonido original; mp3:320, opus:, flac: como en video-get). -c como en video-get.
video-get URL [-f selector] [-o folder] [-c pieces] [--subs langs] [--auto-subs] [--embed-subs] [--adapter name] Descargar un vídeo; -f toma un selector de calidad de video-info (b = el mejor archivo único; ba = solo el sonido tal como lo tiene el sitio, sin convertir; mp3:320, mp3:256, mp3:192 o mp3:128 = el sonido como MP3 a esa tasa de bits, mp3:0 a su mejor tasa variable; opus: = como Opus; flac: = como FLAC, sin pérdidas, pero no mejor que el sonido del sitio; las conversiones necesitan ffmpeg). -c: el propio descargador de DDM trae cada flujo que encuentra yt-dlp a través de esta cantidad de conexiones (8 por defecto, de 1 a 128), un flujo en fragmentos (HLS, DASH) esta cantidad de fragmentos a la vez. --subs guarda los subtítulos junto a él: códigos de idioma de video-info (en,fr), o all para cada uno que el cargador proporcionó; --auto-subs toma los subtítulos automáticos del sitio en su lugar; --embed-subs los incrusta en el vídeo (necesita ffmpeg, MP4 o MKV). --adapter envía las conexiones de las descargas, y las de yt-dlp (y ffmpeg), a través de un adaptador de red, como para get; cuando no está conectado, no se inicia nada.
install-ytdlp, install-ffmpeg Instalar o actualizar las herramientas necesarias para descargar vídeos: yt-dlp (verificado con su clave de firma) y ffmpeg (en Windows; en macOS y Linux, DDM usa la versión del sistema).
torrent-info SOURCE Nombre del torrent, archivos (numerados) y tamaño; SOURCE es un enlace magnet o un archivo .torrent.
torrent-get SOURCE [-o folder] [--files 0,2] [--use-existing] Descargar un torrent o solo algunos de sus archivos. Si algunos ya están en la carpeta, se detiene y los indica; --use-existing los usa en su lugar (se conservan los que coinciden y se descargan los demás).
torrent-create PATH -o file.torrent Crear un .torrent a partir de un archivo o una carpeta (los pares lo encuentran a través de la DHT).
status Las descargas de la aplicación en ejecución, en formato JSON y con sus ID (la API de automatización debe estar activada).
pause ID..., start ID... Pausar las descargas en curso, o iniciar (reanudar) las detenidas, en cola o fallidas, en la aplicación en ejecución.
remove ID..., delete ID... Quitar descargas de la lista de la aplicación en ejecución: remove mantiene sus archivos, delete también los elimina. Una descarga en curso se pausa primero (pause).
api on, api off Activar o desactivar la API de automatización de la aplicación en ejecución.

dannexdownloadmanager-cli help <command>muestra todas las opciones. Si un comando falla (la aplicación no está en ejecución, responde con un error o se interrumpe una descarga), termina con el código 1. Por ejemplo:

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

Con --json (antes o después del comando), cada comando muestra JSON en lugar de texto, con un objeto por línea, para que lo lean los scripts y los agentes de IA:

Comando Imprime
get, resume {"event": "through", "service"}primero, cuando la descarga se realiza a través de una cuenta de debrid; después, una línea {"event": "progress", "downloaded", "size", "speed", "connections", "segments"} cada medio segundo; y, por último, {"event": "done", "path", "size", "seconds"}, o {"event": "paused", "state"} después de Ctrl+C (state es el archivo que ocupa resume).
video-get {"event": "progress", "downloaded", "size", "speed"}líneas y, después, {"event": "done", "path", "subtitles", "subtitle_problems"}: los archivos de subtítulos guardados junto al vídeo y los idiomas que el sitio rechazó ({"code", "name", "reason", "beside"}; beside: se descargaron en un segundo intento, junto al vídeo en lugar de dentro de él).
torrent-get {"event": "progress", "phase", "downloaded", "size", "speed", "peers", "peers_seen"}líneas y, después, {"event": "done", "path", "size"}, o {"event": "stopped", "downloaded", "seconds"} con --seconds.
video-info {"title", "choices": [{"label", "format", "size"}], "subtitles": [{"code", "name", "automatic"}]}; el format de una opción es lo que ocupa video-get -f; el code de un subtítulo es lo que ocupa --subs.
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 La respuesta de la aplicación, que ya está en formato JSON (consulta más abajo).

Los tamaños se indican en bytes (null si se desconoce el tamaño) y las velocidades, en bytes por segundo. Si se produce un error, se muestra {"error": "…"} y el proceso termina con el código 1. Por ejemplo:

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}

La API de automatización

Otros programas pueden preguntar a la aplicación en ejecución qué está descargando, y pausar, iniciar, quitar o eliminar descargas. La API está desactivada de forma predeterminada; actívala con dannexdownloadmanager-cli api on (y desactívala con api off).

Cómo se comunica un programa con DDM

  1. Mientras está en ejecución, DDM escucha en un puerto de 127.0.0.1 (solo en este equipo) y guarda el puerto y un token secreto en ipc.json, dentro de su carpeta de datos: - Windows: %APPDATA%\dannexdownloadmanager\ipc.json - macOS: ~/Library/Application Support/dannexdownloadmanager/ipc.json - Linux: ~/.local/share/dannexdownloadmanager/ipc.json - Una copia portátil: data\ipc.json junto al programa.

El token cambia cada vez que se inicia la aplicación; solo pueden usarlo los programas que puedan leer tu carpeta de datos. 2. Conéctate a ese puerto y envía una línea de JSON con el token y los campos del comando, por ejemplo, {"token": "<token>", "query": "list"}. 3. DDM responde con una línea: ok para un comando o un objeto JSON para una consulta.

Qué entiende

Campos (además de token) Respuesta
{"query": "list"} Cada descarga y la velocidad 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 es Queued, Downloading, Stopped, Complete o Error; size es null si se desconoce; error (por qué falló) solo está disponible para una descarga en Error; category es la key de una categoría; free es el espacio libre donde van las descargas (null si se desconoce). Solo si la API está activada.
{"action": "pause", "ids": [3, 4]} Actúa sobre las descargas por id: "pause", "start", "remove" (conserva el archivo), "delete" (elimina también el archivo) o "folder" (muestra el archivo en su carpeta, como hace Abrir carpeta). Responde {"done": [3], "skipped": [{"id": 4, "why": "not running"}]}; una descarga en curso debe pausarse antes de quitarla o eliminarla. Solo mientras la API está activada.
{"action": "start_queue", "queue": "Main download queue"} Inicia (o con "stop_queue", detiene) la cola con ese nombre (un nombre de la queues de la lista). Responde {"done": [], "skipped": []}, o {"error": …, "code": "unknown-queue"}. Solo si la API está activada.
{"api": true} / {"api": false} Activa o desactiva la API: {"api": true}.
{"url": "https://…", "dir": "D:\\Files", "name": "a.zip", "silent": true} Añade una descarga, como lo hace /d /p /f /n de la línea de comandos ("later": true es /a); ok. "category" (una clave de la categories de la lista) la coloca en la carpeta de esa categoría en lugar de la que elige su tipo; "queue" (el nombre de una cola) es la cola en la que espera con "later". También con la API desactivada, como la línea de comandos.
{"start_queue": true} Inicia la cola principal de descargas; ok.

Una pregunta o acción desconocida recibe {"error": "…"}, al igual que una pregunta mientras la API está desactivada (en ese caso, recibe "code": "api-off", para que los programas puedan comprobarlo: el texto del error puede cambiar). Un token incorrecto recibe denied.

El botón de la barra de herramientas de la extensión del navegador muestra las descargas de DDM con el mismo list, y las pausa, reanuda y abre sus carpetas con las mismas acciones, sea cual sea el interruptor de la API: su ayudante marca lo que pregunta con "browser": true. No pregunta nada más de esa manera.

Cada solicitud y respuesta se describe, campo por campo, en un esquema JSON: automation-api.schema.json (también en https://dannex.kavangi.co.ke/automation-api.schema.json). Se genera a partir del código con el que responde la aplicación, por lo que se mantiene exacto; los programas pueden verificar lo que envían y leen con él, o generar sus tipos a partir de él.

Ejemplos

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 añadir una descarga, envía {"token": "…", "url": "https://example.com/a.zip", "silent": true}.

Gratis, código abierto, sin anuncios, sin prueba.

Descargar Dannex Download Manager