Línea de comandos y automatización

MDM se puede controlar sin 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.
• misterdownloadmanager-cli, una herramienta de línea de comandos independiente: descarga archivos, vídeos y torrents en un terminal, con progreso, sin 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 MDM: consulta Asistentes de IA.

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

misterdownloadmanager.exe /d URL [/p folder] [/f name] [/a] [/n] [/s]

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

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

misterdownloadmanager-cli

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

misterdownloadmanager-cli help <command>muestra todas las opciones. Un comando que falla (la aplicación no se está ejecutando, responde con un error, una descarga se interrumpe) sale con el código 1. Por ejemplo:

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

JSON para scripts y programas

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

Los tamaños están en bytes (null mientras se desconoce), las velocidades en bytes por segundo. Un fallo imprime {"error": "…"} y sale con el código 1. Por ejemplo:

misterdownloadmanager-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, eliminar o borrar descargas. La API está desactivada por defecto; actívela con misterdownloadmanager-cli api on (y desactívela con api off).

Cómo un programa se comunica con MDM

1. Mientras se ejecuta, MDM escucha en un puerto de 127.0.0.1 (solo en este equipo) y escribe el puerto y un token secreto en ipc.json en su carpeta de datos: - Windows: %APPDATA%\misterdownloadmanager\ipc.json - macOS: ~/Library/Application Support/misterdownloadmanager/ipc.json - Linux: ~/.local/share/misterdownloadmanager/ipc.json - Una copia portable: data\ipc.json junto al programa.

El token cambia en cada inicio; solo los programas que pueden leer su carpeta de datos (la suya) pueden usarlo. 2. Conéctese a ese puerto y envíe una línea de JSON: el token y los campos del comando, por ejemplo {"token": "<token>", "query": "list"}. 3. MDM responde con una línea: ok para un comando, o un objeto JSON para una pregunta.

Qué entiende

Una pregunta o acción desconocida se responde {"error": "…"}, al igual que una pregunta mientras la API está desactivada (entonces con "code": "api-off", para que los programas comprueben: el texto del error puede cambiar). Un token incorrecto se responde denied.

Cada solicitud y respuesta se describe, campo por campo, en un esquema JSON: automation-api.schema.json (también en https://misterdownloadmanager.com/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\misterdownloadmanager\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"], "misterdownloadmanager", "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}.