Opdrachtregel en automatisering

MDM kan op drie manieren zonder venster worden aangestuurd:

• De eigen opdrachtregel van de app, dezelfde schakelaars als die van IDM: geef een download door aan de draaiende app vanuit een script, een batchbestand of een ander programma.
• misterdownloadmanager-cli, een afzonderlijk opdrachtregelprogramma: download bestanden, video's en torrents in een terminal, met voortgang, zonder de app.
• De automatiserings-API: andere programma's tonen de downloads van de draaiende app (als JSON) en pauzeren, starten, verwijderen of wissen ze, via een lokaal, met token beveiligd kanaal. AI-assistenten gebruiken het via de MCP-server van MDM: zie AI-assistenten.

De voorbeelden gebruiken Windows-paden; op macOS en Linux hebben de programma's dezelfde namen zonder .exe.

De opdrachtregel van de app

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

Schakelaars kunnen beginnen met / of -, in elk geval. Als MDM draait, gaat de opdracht ernaartoe; zo niet, dan start MDM en voert het de opdracht uit. Bijvoorbeeld:

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

Het wordt geleverd bij elke download van MDM, naast de app (de installatie plaatst het in de map van MDM). Het werkt zelfstandig: de app hoeft niet te draaien, behalve voor status en api.

misterdownloadmanager-cli help <command>toont elke optie. Een commando dat mislukt (de app draait niet, antwoordt met een fout, een download stopt) sluit af met code 1. Bijvoorbeeld:

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 voor scripts en programma's

Met --json (voor of na het commando) print elk commando JSON in plaats van tekst, één object per regel, zodat scripts en AI-agents het kunnen lezen:

Groottes zijn in bytes (null terwijl onbekend), snelheden in bytes per seconde. Een mislukking print {"error": "…"} en sluit af met code 1. Bijvoorbeeld:

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}

De automatiserings-API

Andere programma's kunnen de actieve app vragen wat deze downloadt, en downloads pauzeren, starten, verwijderen of wissen. De API is standaard uitgeschakeld; schakel deze in met misterdownloadmanager-cli api on (en uit met api off).

Hoe een programma met MDM praat

1. Terwijl het draait, luistert MDM op een poort van 127.0.0.1 (alleen deze computer) en schrijft de poort en een geheim token naar ipc.json in de datafolder: - Windows: %APPDATA%\misterdownloadmanager\ipc.json - macOS: ~/Library/Application Support/misterdownloadmanager/ipc.json - Linux: ~/.local/share/misterdownloadmanager/ipc.json - Een draagbare kopie: data\ipc.json naast het programma.

Het token verandert bij elke start; alleen programma's die uw datafolder kunnen lezen (die van u) kunnen het gebruiken. 2. Maak verbinding met die poort en stuur één regel JSON: het token en de velden van het commando, bijv. {"token": "<token>", "query": "list"}. 3. MDM antwoordt met één regel: ok voor een commando, of een JSON-object voor een vraag.

Wat het begrijpt

Een onbekende vraag of actie wordt beantwoord met {"error": "…"}, evenals een vraag terwijl de API uitgeschakeld is (dan met "code": "api-off", zodat programma's dit kunnen controleren: de fouttekst kan veranderen). Een verkeerd token wordt beantwoord met denied.

Elke aanvraag en elk antwoord wordt veld voor veld beschreven in een JSON Schema: automation-api.schema.json (ook op https://misterdownloadmanager.com/automation-api.schema.json). Het is gemaakt van de code waarmee de app antwoordt, dus het blijft exact; programma's kunnen controleren wat ze verzenden en lezen, of hun typen ervan genereren.

Voorbeelden

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"])

Om in plaats daarvan een download toe te voegen, stuurt u {"token": "…", "url": "https://example.com/a.zip", "silent": true}.