Befehlszeile und Automatisierung

MDM kann auf drei Arten ohne sein Fenster gesteuert werden:

• Die eigene Befehlszeile der App, die gleichen Schalter wie bei IDM: Übergeben Sie einen Download von einem Skript, einer Batch-Datei oder einem anderen Programm an die laufende App.
• misterdownloadmanager-cli, ein separates Befehlszeilen-Tool: Laden Sie Dateien, Videos und Torrents in einem Terminal mit Fortschritt herunter, ohne die App.
• Die Automatisierungs-API: Andere Programme listen die Downloads der laufenden App (als JSON) auf und pausieren, starten, entfernen oder löschen sie über einen lokalen, Token-geschützten Kanal. KI-Assistenten verwenden sie über den MCP-Server von MDM: siehe KI-Assistenten.

Die Beispiele verwenden Windows-Pfade; unter macOS und Linux haben die Programme die gleichen Namen ohne .exe.

Die Befehlszeile der App

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

Schalter können mit / oder - beginnen, in jedem Fall. Wenn MDM läuft, wird der Befehl an MDM gesendet; wenn nicht, startet MDM und führt ihn aus. Zum Beispiel:

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

Es wird mit jedem Download von MDM geliefert, neben der App (der Installer legt es in MDMs Ordner ab). Es funktioniert eigenständig: Die App muss nicht laufen, außer für status und api.

misterdownloadmanager-cli help <command>zeigt alle Optionen. Ein Befehl, der fehlschlägt (die App läuft nicht, sie antwortet mit einem Fehler, ein Download bricht ab), wird mit dem Code 1 beendet. Zum Beispiel:

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 für Skripte und Programme

Mit --json (vor oder nach dem Befehl) gibt jeder Befehl JSON anstelle von Text aus, ein Objekt pro Zeile, damit Skripte und KI-Agenten es lesen können:

Größen sind in Bytes (null während unbekannt), Geschwindigkeiten in Bytes pro Sekunde. Ein Fehler gibt {"error": "…"} aus und beendet sich mit Code 1. Zum Beispiel:

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}

Die Automatisierungs-API

Andere Programme können die laufende App fragen, was sie herunterlädt, und Downloads anhalten, starten, entfernen oder löschen. Die API ist standardmäßig ausgeschaltet; schalten Sie sie mit misterdownloadmanager-cli api on ein (und mit api off aus).

Wie ein Programm mit MDM kommuniziert

1. Während MDM läuft, lauscht es an einem Port von 127.0.0.1 (nur dieser Computer) und schreibt den Port und ein geheimes Token in ipc.json in seinem Datenordner: - Windows: %APPDATA%\misterdownloadmanager\ipc.json - macOS: ~/Library/Application Support/misterdownloadmanager/ipc.json - Linux: ~/.local/share/misterdownloadmanager/ipc.json - Eine portable Kopie: data\ipc.json neben dem Programm.

Das Token ändert sich bei jedem Start; nur Programme, die Ihren Datenordner (Ihren) lesen können, können es verwenden. 2. Verbinden Sie sich mit diesem Port und senden Sie eine Zeile JSON: das Token und die Felder des Befehls, z.B. {"token": "<token>", "query": "list"}. 3. MDM antwortet mit einer Zeile: ok für einen Befehl oder ein JSON-Objekt für eine Frage.

Was es versteht

Eine unbekannte Frage oder Aktion wird mit {"error": "…"} beantwortet, ebenso eine Frage, während die API ausgeschaltet ist (dann mit "code": "api-off", damit Programme dies überprüfen können: der Fehlertext kann sich ändern). Ein falsches Token wird mit denied beantwortet.

Jede Anfrage und Antwort wird Feld für Feld in einem JSON-Schema beschrieben: automation-api.schema.json (auch unter https://misterdownloadmanager.com/automation-api.schema.json). Es wird aus dem Code erstellt, mit dem die App antwortet, sodass es genau bleibt; Programme können überprüfen, was sie senden und lesen, oder ihre Typen daraus generieren.

Beispiele

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

Um stattdessen einen Download hinzuzufügen, senden Sie {"token": "…", "url": "https://example.com/a.zip", "silent": true}.