1. Home
  2. Help
  3. Opdrachtregel en automatisering

Opdrachtregel en automatisering

MDM kan op drie manieren zonder venster worden aangestuurd:

  • De eigen opdrachtregel van de app, met dezelfde opties als IDM: stuur vanuit een script, batchbestand of ander programma een download naar de app als die al actief is.
  • mattdownloadmanager-cli, een afzonderlijk opdrachtregelprogramma: download bestanden, video's en torrents in een terminal, met voortgang, zonder de app.
  • De automatiserings-API: andere programma's kunnen de downloads van de actieve app (als JSON) weergeven en pauzeren, starten, verwijderen of wissen via een lokaal kanaal dat met een token is beveiligd. AI-assistenten gebruiken deze API via de MCP-server van MDM: zie AI-assistenten.

Om de hele app zonder venster te draaien, op een thuisserver of een NAS, zie MDM op een server draaien (mattdownloadmanager --headless); om het vanaf een telefoon te bedienen, zie MDM bedienen vanaf uw telefoon.

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

De opdrachtregel van de app

mattdownloadmanager.exe /d URL [/p folder] [/f name] [/a] [/n] [/s]
Optie Wat het doet
/d URL Het adres om te downloaden.
/p folder Opslaan in deze map (anders in de map voor deze categorie uit Opties → Opslaan in).
/f name Sla het op onder deze naam.
/a Toevoegen aan de hoofddownloadwachtrij zonder de download te starten.
/n Stil: geen venster Bestandsinfo downloaden; de download start meteen (of wordt in de wachtrij geplaatst met /a).
/s Start de hoofddownloadwachtrij.
/exit Sla de draaiende app op en sluit deze (de installatie gebruikt dit voor een upgrade).
/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.
een bestand .torrent of link magnet: Open het in Torrent toevoegen (wat Windows doorgeeft wanneer MDM torrents opent).

Opties kunnen beginnen met / of -, ongeacht hoofd- of kleine letters. Als MDM actief is, wordt de opdracht daarheen gestuurd; zo niet, dan start MDM en voert het de opdracht uit. Bijvoorbeeld:

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

Het wordt meegeleverd bij elke download van MDM en staat naast de app (het installatieprogramma plaatst het in de map van MDM). Het werkt zelfstandig: de app hoeft niet actief te zijn, behalve voor status en api.

Opdracht Wat het doet
get URL [-o folder\|file] [-c connections] [-H "Header: value"]... [--checksum hash] [--dns choice] [--adapter name] Een bestand downloaden met maximaal 8 verbindingen (-c, 1 tot 128) en de voortgang weergeven. Ctrl+C pauzeert de download; resume hervat deze. --checksum controleert het voltooide bestand op hex MD5, SHA-1, SHA-256, SHA-512 of CRC32, eventueel met een naam (sha256:…). --dns kiest de DNS: system (de standaardinstelling); een dienst en de manier waarop die wordt aangesproken, cloudflare-https, quad9-tls, google-plain, adguard-https, nextdns-tls; DNS-serveradressen, 9.9.9.9,149.112.112.112; of een DNS-over-HTTPS-adres. Er wordt nooit teruggevallen op de DNS van het systeem. --adapter stuurt elke verbinding via één netwerkadapter, op basis van de naam (Ethernet, wg0) of een van de adressen. Als de adapter niet is verbonden, wordt er niets verzonden en mislukt de download. Een link van een bestandshost die door een van uw debrid-accounts wordt ondersteund (Opties → Accounts), wordt net als in de app via dat account geopend. get geeft through Real-Debrid aan; --direct downloadt het adres zelf (Debrid-serviceaccounts).
resume file.mdm.json [-c connections] [-H ...] [--direct] Een gepauzeerde of onderbroken download hervatten vanaf het bestand .mdm.json dat ernaast staat. Via een debrid-account, zoals met get: de dienst geeft een nieuwe link als de oude is verlopen; --direct gaat verder vanaf het adres zelf.
install-gallery-dl gallery-dl voor afbeeldingsgalerijen installeren of bijwerken: de controlesomlijst wordt gecontroleerd met de ondertekeningssleutel van de auteur en het programma met die lijst (Windows en Linux x86-64; op andere systemen installeert u het zelf).
gallery-get URL [-o folder] [--limit N] [--adapter name] Download de afbeeldingen van een galerij (een Wikimedia Commons-categorie, een Flickr-album, ...) naar een map die ernaar is genoemd in -o; --limit neemt er maximaal zoveel, de eerste die de site vermeldt. Als het opnieuw wordt gestart, haalt het alleen de nieuwe op. MDM's eigen downloader haalt de afbeeldingen op die gallery-dl vermeldt, 4 tegelijk. --adapter stuurt de verbindingen, die van MDM en gallery-dl, via één netwerkadapter, net als voor get.
video-info URL Welke video een pagina bevat (YouTube, Vimeo, ...) en uit welke kwaliteiten u kunt kiezen.
playlist-info URL [--from N] [--count N] De video's van een afspeellijst of kanaal, één per regel en in de volgorde waarin ze worden vermeld: de positie, duur, titel en het adres.
playlist-get URL [-f selector] [-o folder] [-c pieces] [--from N] [--count N] Download de video's van een afspeellijst of kanaal een voor een, in een map met de naam van de lijst in -o. -f is één kwaliteit voor alles, zoals voor video-get (standaard de beste van elke video; bv*[height<=720]+ba/b[height<=720] = tot 720p; ba = het originele geluid; mp3:320, opus:, flac: zoals voor video-get). -c zoals voor video-get.
video-get URL [-f selector] [-o folder] [-c pieces] [--subs langs] [--auto-subs] [--embed-subs] [--adapter name] Een video downloaden; -f neemt een kwaliteitsselector van video-info (b = het beste losse bestand; ba = alleen het geluid zoals de site het heeft, niet geconverteerd; mp3:320, mp3:256, mp3:192 of mp3:128 = het geluid als een MP3 met die bitrate, mp3:0 met de beste variabele bitrate; opus: = als Opus; flac: = als FLAC, lossless maar niet beter dan het geluid van de site; conversies vereisen ffmpeg). -c: MDM's eigen downloader haalt elke stream die yt-dlp vindt op via dit aantal verbindingen (8 standaard, 1 tot 128), een stream in delen (HLS, DASH) dit aantal delen tegelijk. --subs slaat ondertitels ernaast op: taalcodes van video-info (en,fr), of all voor elke taal die de uploader heeft opgegeven; --auto-subs gebruikt in plaats daarvan de automatische ondertitels van de site; --embed-subs voegt ze toe aan de video (vereist ffmpeg, MP4 of MKV). Met ffmpeg worden de hoofdstukken van de video ook in het bestand geplaatst, net zoals Hoofdstukken insluiten van Video downloaden. --adapter stuurt de downloadverbindingen, en die van yt-dlp (en ffmpeg), via één netwerkadapter, zoals voor get; als deze niet is verbonden, start er niets.
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 De naam, bestanden (genummerd) en grootte van een torrent; SOURCE is een magneetlink of een .torrent bestand.
torrent-get SOURCE [-o folder] [--files 0,2] [--use-existing] Download een torrent, of slechts enkele van de bestanden. Als sommige bestanden al in de map staan, stopt het programma en noemt ze; --use-existing gebruikt ze dan in plaats daarvan (wat overeenkomt, wordt behouden, de rest gedownload).
torrent-create PATH -o file.torrent Maak een .torrent van een bestand of map (peers vinden het via de DHT).
status De downloads van de draaiende app, als JSON, met hun ID's (de automatiserings-API moet zijn ingeschakeld).
pause ID..., start ID... Pauzeer actieve downloads, of start (hervat) gestopte, in de wachtrij geplaatste of mislukte downloads in de actieve app.
remove ID..., delete ID... Verwijder downloads uit de lijst van de actieve app: remove behoudt de bestanden, delete verwijdert ze ook. Een actieve download wordt eerst gepauzeerd (pause).
api on, api off Schakel de automatiserings-API van de actieve app in of uit.

mattdownloadmanager-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:

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 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:

Opdracht Print
get, resume {"event": "through", "service"}eerst wanneer de download via een debrid-account gaat, dan elke halve seconde een {"event": "progress", "downloaded", "size", "speed", "connections", "segments"}-regel, dan {"event": "done", "path", "size", "seconds"}, of {"event": "paused", "state"} na Ctrl+C (state is het bestand dat resume neemt).
video-get {"event": "progress", "downloaded", "size", "speed"}regels, dan {"event": "done", "path", "subtitles", "subtitle_problems"}: de ondertitelbestanden die ernaast zijn opgeslagen, en de talen die de site weigerde ({"code", "name", "reason", "beside"}; beside: ze kwamen bij een tweede poging, naast de video in plaats van erin).
torrent-get {"event": "progress", "phase", "downloaded", "size", "speed", "peers", "peers_seen"}regels, dan {"event": "done", "path", "size"}, of {"event": "stopped", "downloaded", "seconds"} met --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 Het antwoord van de app, dat al JSON is (zie hieronder).

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

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}

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 mattdownloadmanager-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%\mattdownloadmanager\ipc.json - macOS: ~/Library/Application Support/mattdownloadmanager/ipc.json - Linux: ~/.local/share/mattdownloadmanager/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

Velden (naast token) Antwoord
{"query": "list"} Elke download en de totale snelheid: {"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 is Queued, Downloading, Stopped, Complete of Error; size is null wanneer onbekend; error (waarom het mislukte) is er alleen voor een download in Error; category is de key van een categorie; free is de vrije ruimte waar downloads naartoe gaan (null wanneer onbekend). Alleen als de API is ingeschakeld.
{"action": "pause", "ids": [3, 4]} Handelt op downloads per ID: "pause", "start", "remove" (bestand behouden) of "delete" (bestand ook verwijderd). Antwoordt {"done": [3], "skipped": [{"id": 4, "why": "not running"}]}; een actieve download moet gepauzeerd worden voordat deze wordt verwijderd of gewist. Alleen terwijl de API aan staat.
{"action": "start_queue", "queue": "Main download queue"} Start (of met "stop_queue", stopt) de wachtrij met die naam (een naam uit de queues van de lijst). Antwoordt {"done": [], "skipped": []}, of {"error": …, "code": "unknown-queue"}. Alleen als de API is ingeschakeld.
{"api": true} / {"api": false} Schakelt de API in of uit: {"api": true}.
{"url": "https://…", "dir": "D:\\Files", "name": "a.zip", "silent": true} Voegt een download toe, zoals de /d /p /f /n van de opdrachtregel doen ("later": true is /a); ok. "category" (een sleutel uit de categories van de lijst) plaatst het in de map van die categorie in plaats van degene die het type kiest; "queue" (de naam van een wachtrij) is de wachtrij waarin het wacht met "later". Ook met de API uitgeschakeld, net als de opdrachtregel.
{"start_queue": true} Start de hoofddownloadwachtrij; ok.

Een onbekende vraag of actie krijgt als antwoord {"error": "…"}. Dat geldt ook voor een vraag wanneer de API is uitgeschakeld (dan is het antwoord "code": "api-off", zodat programma's dit kunnen controleren: de fouttekst kan veranderen). Een ongeldig token krijgt als antwoord denied.

Elke aanvraag en elk antwoord wordt veld voor veld beschreven in een JSON Schema: automation-api.schema.json (ook op https://idm.teachermatt.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\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"])

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

Gratis, open source, geen advertenties, geen proefversie.

Matt Download Manager downloaden