DDM 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.
dannexdownloadmanager-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 DDM: zie AI-assistenten.
Om de hele app zonder venster te draaien, op een thuisserver of een NAS, zie DDM op een server draaien (dannexdownloadmanager --headless); om het vanaf een telefoon te bedienen, zie DDM 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
dannexdownloadmanager.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 |
Starten in het systeemvak, het venster verborgen: zo start DDM wanneer u zich aanmeldt, als Dannex Download Manager starten bij opstarten is ingeschakeld. Waar geen systeemvakpictogram van DDM wordt weergegeven (sommige Linux-desktops), start DDM geminimaliseerd. Een reeds actieve DDM blijft ongewijzigd. |
een bestand .torrent of link magnet: |
Open het in Torrent toevoegen (wat Windows doorgeeft wanneer DDM torrents opent). |
Opties kunnen beginnen met / of -, ongeacht hoofd- of kleine letters. Als DDM actief is, wordt de opdracht daarheen gestuurd; zo niet, dan start DDM en voert het de opdracht uit. Bijvoorbeeld:
dannexdownloadmanager.exe /d https://example.com/files/report.pdf /p D:\Reports /n
dannexdownloadmanager.exe /d https://example.com/big.iso /a
dannexdownloadmanager.exe /s
dannexdownloadmanager-cli
Het wordt meegeleverd bij elke download van DDM en staat naast de app (het installatieprogramma plaatst het in de map van DDM). 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] [-c N] [--adapter name] |
Download de afbeeldingen van een galerij (een categorie van Wikimedia Commons, een Flickr-album, ...) naar een map die naar de galerij is vernoemd in -o: gallery-dl maakt de lijst, de downloader van DDM haalt ze binnen, -c tegelijk (standaard 8, zoals de verbindingen van get); --limit neemt er hooguit zoveel, de eerste die de site toont. Opnieuw gestart haalt het alleen de nieuwe op. --adapter stuurt zijn verbindingen, en die van gallery-dl, via één netwerkadapter, zoals bij 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] |
Download een video; -f kiest 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 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: DDM's eigen downloader haalt elke stream die yt-dlp vindt op via dit aantal verbindingen (standaard 8, 1 tot 128), een stream in stukjes (HLS, DASH) dit aantal stukjes tegelijk. --subs slaat ondertitels ernaast op: taalcodes van video-info (en,fr), of all voor elke ondertitel 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). --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 |
De benodigde hulpprogramma's voor video's installeren of bijwerken: yt-dlp (gecontroleerd met de ondertekeningssleutel) en ffmpeg (op Windows; op macOS en Linux gebruikt DDM de versie van het systeem). |
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. |
dannexdownloadmanager-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:
dannexdownloadmanager-cli get https://example.com/big.iso -o D:\Downloads -c 16 --checksum sha256:9f86d0…
dannexdownloadmanager-cli video-get "https://www.youtube.com/watch?v=aqz-KE-bpKQ" -f "b[height=720]"
dannexdownloadmanager-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 | |
|---|---|
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"}], "subtitles": [{"code", "name", "automatic"}]}; de format van een keuze is wat video-get -f neemt, de code van een ondertitel is wat --subs neemt. |
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:
dannexdownloadmanager-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 dannexdownloadmanager-cli api on (en uit met api off).
Hoe een programma met DDM praat
- Terwijl het draait, luistert DDM op een poort van
127.0.0.1(alleen deze computer) en schrijft de poort en een geheim token naaripc.jsonin de datafolder: - Windows:%APPDATA%\dannexdownloadmanager\ipc.json- macOS:~/Library/Application Support/dannexdownloadmanager/ipc.json- Linux:~/.local/share/dannexdownloadmanager/ipc.json- Een draagbare kopie:data\ipc.jsonnaast 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. DDM 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]} |
Voert acties uit op downloads via id: "pause", "start", "remove" (bestand blijft behouden), "delete" (bestand ook verwijderd) of "folder" (toont het bestand in zijn map, zoals Map openen doet). Antwoordt {"done": [3], "skipped": [{"id": 4, "why": "not running"}]}; een lopende download moet worden gepauzeerd voordat ze uit de lijst wordt gehaald of verwijderd. Alleen wanneer 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.
De werkbalkknop van de browserextensie toont de downloads van DDM met dezelfde list, en pauzeert, hervat en opent hun mappen met dezelfde acties, ongeacht de schakelaar van de API: de helper markeert wat hij vraagt met "browser": true. Op die manier vraagt hij niets anders.
Elke aanvraag en elk antwoord wordt veld voor veld beschreven in een JSON Schema: automation-api.schema.json (ook op https://dannex.kavangi.co.ke/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\dannexdownloadmanager\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"], "dannexdownloadmanager", "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.
Dannex Download Manager downloaden