1. Startseite
  2. Hilfe
  3. Befehlszeile und Automatisierung

Befehlszeile und Automatisierung

MDM lässt sich auf drei Arten ohne geöffnetes Fenster steuern:

  • Die Befehlszeile der App verwendet dieselben Schalter wie IDM. Damit lässt sich ein Download von einem Skript, einer Batch-Datei oder einem anderen Programm an die laufende App übergeben.
  • mattdownloadmanager-cli ist ein separates Befehlszeilenprogramm. Damit lassen sich Dateien, Videos und Torrents im Terminal mit Fortschrittsanzeige herunterladen, ohne die App zu verwenden.
  • Die Automatisierungs-API: Andere Programme können die Downloads der laufenden App als JSON auflisten und sie pausieren, starten, entfernen oder löschen. Dafür verwenden sie einen lokalen, durch ein Token geschützten Kanal. KI-Assistenten greifen über den MCP-Server von MDM darauf zu: siehe KI-Assistenten.

Um die gesamte App ohne Fenster auf einem Heimserver oder NAS auszuführen, siehe MDM auf einem Server ausführen (mattdownloadmanager --headless); um sie von einem Telefon aus zu steuern, MDM von Ihrem Telefon aus steuern.

Die Beispiele verwenden Windows-Pfade. Unter macOS und Linux haben die Programme dieselben Namen, nur ohne .exe.

Die Befehlszeile der App

mattdownloadmanager.exe /d URL [/p folder] [/f name] [/a] [/n] [/s]
Schalter Beschreibung
/d URL Die herunterzuladende Adresse.
/p folder In diesem Ordner speichern (sonst im Ordner der Kategorie unter Optionen → Speichern unter).
/f name Unter diesem Namen speichern.
/a Zur Hauptwarteschlange hinzufügen, ohne den Download zu starten.
/n Ohne Fenster Dateiinformationen herunterladen starten oder den Download sofort in die Warteschlange stellen (/a).
/s Starten Sie die Haupt-Download-Warteschlange.
/exit Laufende App speichern und schließen (wird vom Installationsprogramm vor einem Upgrade verwendet).
/startup Start in the notification area, the window hidden: what Launch Matt Download Manager on startup starts MDM with when you sign in. Where no notification area shows MDM's icon (some Linux desktops), MDM starts minimized. A running MDM stays as it is.
eine .torrent-Datei oder einen magnet:-Link In Torrent hinzufügen öffnen (wird von Windows übergeben, wenn MDM Torrents öffnet).

Schalter können mit / oder - beginnen, unabhängig von der Groß- und Kleinschreibung. Wenn MDM läuft, wird der Befehl an die App gesendet. Andernfalls wird MDM gestartet und führt ihn aus. Zum Beispiel:

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

mattdownloadmanager-cli

Das Programm ist in jedem MDM-Download neben der App enthalten (das Installationsprogramm legt es im MDM-Ordner ab). Es funktioniert eigenständig: Die App muss nicht laufen, außer für status und api.

Befehl Beschreibung
get URL [-o folder\|file] [-c connections] [-H "Header: value"]... [--checksum hash] [--dns choice] [--adapter name] Lädt eine Datei mit bis zu 8 Verbindungen (-c, 1 bis 128) herunter und zeigt den Fortschritt an. Ctrl+C pausiert den Download; resume setzt ihn fort. --checksum prüft die fertige Datei auf Hex-MD5, SHA-1, SHA-256, SHA-512 oder CRC32, optional mit Namen (sha256:…). --dns legt den DNS fest: system (Standard); einen Dienst und die Art der Abfrage, cloudflare-https, quad9-tls, google-plain, adguard-https, nextdns-tls; DNS-Server-Adressen, 9.9.9.9,149.112.112.112; oder eine DNS-over-HTTPS-Adresse. Es wird nicht auf den System-DNS zurückgegriffen. --adapter leitet jede Verbindung über einen Netzwerkadapter, angegeben anhand seines Namens (Ethernet, wg0) oder einer seiner Adressen. Ist der Adapter nicht verbunden, wird nichts gesendet und der Download schlägt fehl. Ein Link von einem Dateihost, der von einem Ihrer Debrid-Konten (Optionen → Konten) unterstützt wird, wird wie in der App über dieses Konto aufgerufen. get gibt through Real-Debrid aus; --direct lädt die Adresse selbst herunter (Debrid-Dienstkonten).
resume file.mdm.json [-c connections] [-H ...] [--direct] Setzt einen pausierten oder unterbrochenen Download anhand der danebenliegenden .mdm.json-Datei fort. Über ein Debrid-Konto wie bei get stellt der Dienst einen neuen Link bereit, wenn der alte abgelaufen ist. --direct setzt den Download über die Adresse selbst fort.
install-gallery-dl Installiert oder aktualisiert gallery-dl für Bildergalerien. Die Prüfsummenliste wird mit dem Signierschlüssel des Autors abgeglichen, das Programm mit dieser Liste (Windows und Linux x86-64; auf anderen Systemen selbst installieren).
gallery-get URL [-o folder] [--limit N] [--adapter name] Bilder einer Galerie (eine Wikimedia-Commons-Kategorie, ein Flickr-Album usw.) in einen nach ihr benannten Ordner in -o herunterladen; --limit nimmt höchstens so viele, die ersten, die die Website auflistet. Wenn es erneut gestartet wird, werden nur die neuen heruntergeladen. MDMs eigener Downloader lädt die von gallery-dl aufgelisteten Bilder herunter, 4 auf einmal. --adapter sendet die Verbindungen, MDMs und gallery-dls, über einen Netzwerkadapter, wie für get.
video-info URL Welche Videos eine Seite enthält (YouTube, Vimeo usw.) und welche Qualitätsstufen verfügbar sind.
playlist-info URL [--from N] [--count N] Die Videos einer Wiedergabeliste oder eines Kanals, jeweils in einer Zeile in der aufgeführten Reihenfolge: Position, Länge, Titel und Adresse.
playlist-get URL [-f selector] [-o folder] [-c pieces] [--from N] [--count N] Videos einer Playlist oder eines Kanals nacheinander in einen nach der Liste benannten Ordner in -o herunterladen. -f ist eine Qualität für alle, wie bei video-get (standardmäßig die beste jedes Videos; bv*[height<=720]+ba/b[height<=720] = bis zu 720p; ba = der Originalton; mp3:320, opus:, flac: wie bei video-get). -c wie bei video-get.
video-get URL [-f selector] [-o folder] [-c pieces] [--subs langs] [--auto-subs] [--embed-subs] [--adapter name] Ein Video herunterladen; -f wählt die Qualität aus video-info (b = die beste einzelne Datei; ba = nur der Ton, wie er auf der Website vorliegt, nicht konvertiert; mp3:320, mp3:256, mp3:192 oder mp3:128 = der Ton als MP3 mit der entsprechenden Bitrate, mp3:0 mit der besten variablen Bitrate; opus: = als Opus; flac: = als FLAC, verlustfrei, aber nicht besser als der Ton der Website; Konvertierungen erfordern ffmpeg). -c: MDMs eigener Downloader lädt jeden von yt-dlp gefundenen Stream über diese Anzahl von Verbindungen (standardmäßig 8, 1 bis 128), einen Stream in Teilen (HLS, DASH) mit dieser Anzahl von Teilen gleichzeitig. --subs speichert Untertitel daneben: Sprachcodes von video-info (en,fr), oder all für alle vom Uploader bereitgestellten; --auto-subs verwendet stattdessen die automatischen Untertitel der Website; --embed-subs bettet sie in das Video ein (erfordert ffmpeg, MP4 oder MKV). Mit ffmpeg werden die Kapitel des Videos ebenfalls in die Datei geschrieben, wie es Kapitel einbetten von Video herunterladen tut. --adapter leitet die Download-Verbindungen sowie die von yt-dlp (und ffmpeg) über einen Netzwerkadapter, wie bei get; wenn dieser nicht verbunden ist, startet nichts.
install-ytdlp, install-ffmpeg Install or update the helpers videos need: yt-dlp (checked against its signing key) and ffmpeg (x64 and ARM64 Windows; on macOS and Linux MDM uses the system's, and on 32-bit Windows one you choose in Helpers).
torrent-info SOURCE Name, Dateien (nummeriert) und Größe eines Torrents; SOURCE ist ein Magnet-Link oder eine .torrent-Datei.
torrent-get SOURCE [-o folder] [--files 0,2] [--use-existing] Lädt einen Torrent oder nur einige seiner Dateien herunter. Wenn einige Dateien bereits im Ordner vorhanden sind, wird der Vorgang angehalten und die Dateien werden aufgelistet; --use-existing verwendet sie stattdessen (übereinstimmende Dateien bleiben erhalten, der Rest wird heruntergeladen).
torrent-create PATH -o file.torrent Erstellen Sie einen .torrent für eine Datei oder einen Ordner (Peers finden ihn über das DHT).
status Die Downloads der laufenden App als JSON, mit ihren IDs (die Automatisierungs-API muss aktiviert sein).
pause ID..., start ID... Laufende Downloads anhalten oder gestoppte, in der Warteschlange befindliche oder fehlgeschlagene Downloads in der laufenden App starten (fortsetzen).
remove ID..., delete ID... Downloads aus der Liste der laufenden App entfernen: remove behält die Dateien, delete löscht sie ebenfalls. Ein laufender Download wird zuerst angehalten (pause).
api on, api off Die Automatisierungs-API der laufenden App ein- oder ausschalten.

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

mattdownloadmanager-cli get https://example.com/big.iso -o D:\Downloads -c 16 --checksum sha256:9f86d0…
mattdownloadmanager-cli video-get "https://www.youtube.com/watch?v=aqz-KE-bpKQ" -f "b[height=720]"
mattdownloadmanager-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:

Befehl Gibt aus
get, resume {"event": "through", "service"}zuerst, wenn der Download über ein Debrid-Konto läuft, dann alle halbe Sekunde eine {"event": "progress", "downloaded", "size", "speed", "connections", "segments"}-Zeile, dann {"event": "done", "path", "size", "seconds"} oder {"event": "paused", "state"} nach Ctrl+C (state ist die Datei, die resume verwendet).
video-get {"event": "progress", "downloaded", "size", "speed"}Zeilen, dann {"event": "done", "path", "subtitles", "subtitle_problems"}: die daneben gespeicherten Untertiteldateien und die Sprachen, die die Website abgelehnt hat ({"code", "name", "reason", "beside"}; beside: Sie wurden beim zweiten Versuch heruntergeladen und neben dem Video statt darin gespeichert).
torrent-get {"event": "progress", "phase", "downloaded", "size", "speed", "peers", "peers_seen"}Zeilen, dann {"event": "done", "path", "size"}, oder {"event": "stopped", "downloaded", "seconds"} mit --seconds.
video-info {"title", "choices": [{"label", "format", "size", "approx", "height", "fps", "codec", "range"}], "subtitles": [{"code", "name", "automatic"}], "declared"}; declared is the address of the video the page says it is about, when that one was looked up instead of the first player in its HTML (on a site yt-dlp has no reader of its own for), else null; a choice's format is what video-get -f takes (the very formats it was sized from, as 401+251, then the nearest should those be gone), approx says its size is an estimate, codec is AV1, VP9, H.264…, range is HDR (or SDR beside an HDR choice); a subtitle's code is what --subs takes.
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 Die Antwort der App, die bereits JSON ist (siehe unten).

Größen werden in Bytes angegeben (null, solange unbekannt), Geschwindigkeiten in Bytes pro Sekunde. Bei einem Fehler wird {"error": "…"} ausgegeben und der Prozess mit Code 1 beendet. Zum Beispiel:

mattdownloadmanager-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 mattdownloadmanager-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 auf 127.0.0.1 (nur auf diesem Computer) und schreibt den Port und ein geheimes Token in ipc.json in seinem Datenordner: - Windows: %APPDATA%\mattdownloadmanager\ipc.json - macOS: ~/Library/Application Support/mattdownloadmanager/ipc.json - Linux: ~/.local/share/mattdownloadmanager/ipc.json - Eine portable Kopie: data\ipc.json neben dem Programm.

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

Was es versteht

Felder (außer token) Antwort
{"query": "list"} Jeder Download und die Gesamtgeschwindigkeit: {"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 ist Queued, Downloading, Stopped, Complete oder Error; size ist null, wenn unbekannt; error (warum es fehlgeschlagen ist) ist nur für einen Download in Error vorhanden; category ist der key einer Kategorie; free ist der freie Speicherplatz, auf den Downloads gehen (null, wenn unbekannt). Nur wenn die API eingeschaltet ist.
{"action": "pause", "ids": [3, 4]} Führt Aktionen für Downloads anhand ihrer ID aus: "pause", "start", "remove" (Datei behalten) oder "delete" (Datei ebenfalls löschen). Antwortet mit {"done": [3], "skipped": [{"id": 4, "why": "not running"}]}; ein laufender Download muss angehalten werden, bevor er entfernt oder gelöscht wird. Nur wenn die API eingeschaltet ist.
{"action": "start_queue", "queue": "Main download queue"} Startet (oder mit "stop_queue" stoppt) die Warteschlange dieses Namens (ein Name aus der queues der Liste). Antwortet {"done": [], "skipped": []} oder {"error": …, "code": "unknown-queue"}. Nur wenn die API eingeschaltet ist.
{"api": true} / {"api": false} Schaltet die API ein oder aus: {"api": true}.
{"url": "https://…", "dir": "D:\\Files", "name": "a.zip", "silent": true} Fügt einen Download hinzu, wie es die /d /p /f /n der Befehlszeile tun ("later": true ist /a); ok. "category" (ein Schlüssel aus der categories der Liste) legt ihn in den Ordner dieser Kategorie anstelle des Ordners, den sein Typ auswählt; "queue" (der Name einer Warteschlange) ist die Warteschlange, in der er mit "later" wartet. Auch wenn die API ausgeschaltet ist, wie bei der Befehlszeile.
{"start_queue": true} Startet die Haupt-Download-Warteschlange; ok.

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://idm.teachermatt.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\mattdownloadmanager\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"], "mattdownloadmanager", "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}.

Kostenlos, Open Source, keine Werbung, keine Testversion.

Matt Download Manager herunterladen