DDM può essere gestito senza la sua finestra in tre modi:
- La riga di comando dell'app, con le stesse opzioni di IDM: passa un download all'app in esecuzione da uno script, un file batch o un altro programma.
dannexdownloadmanager-cli, uno strumento separato da usare nel terminale: scarica file, video e torrent mostrando l'avanzamento, senza aprire l'app.- L'API di automazione: altri programmi elencano i download dell'app in esecuzione (come JSON) e li mettono in pausa, avviano, rimuovono o eliminano, tramite un canale locale protetto da token. Gli assistenti AI la usano tramite il server MCP di DDM: vedi Assistenti AI.
Per eseguire l'intera app senza finestra, su un server domestico o un NAS, vedi Eseguire DDM su un server (dannexdownloadmanager --headless); per controllarla da telefono, vedi Controllare DDM dal telefono.
Gli esempi usano i percorsi di Windows; su macOS e Linux i programmi hanno gli stessi nomi senza .exe.
La riga di comando dell'app
dannexdownloadmanager.exe /d URL [/p folder] [/f name] [/a] [/n] [/s]
| Opzione | Cosa fa |
|---|---|
/d URL |
L'indirizzo da cui scaricare. |
/p folder |
Salvalo in questa cartella (altrimenti usa la cartella della categoria indicata in Opzioni → Salva in). |
/f name |
Salvalo con questo nome. |
/a |
Aggiungilo alla coda di download principale senza avviarlo. |
/n |
Modalità silenziosa: non mostrare la finestra Informazioni sul file da scaricare; il download inizia subito (o viene messo in coda, con /a). |
/s |
Avvia la coda di download principale. |
/exit |
Salva e chiudi l'app in esecuzione (il programma di installazione lo usa prima di un aggiornamento). |
/startup |
Avvia DDM nell'area di notifica, con la finestra nascosta: così Avvia Dannex Download Manager all'avvio del sistema avvia DDM quando accedi. Dove non c'è un'area di notifica per l'icona di DDM (alcuni desktop Linux), DDM si avvia ridotto a icona. Se DDM è già in esecuzione, resta come si trova. |
un file .torrent o un collegamento magnet: |
Aprilo in Aggiungi torrent (è l'opzione che Windows usa quando apre i torrent con DDM). |
Le opzioni possono iniziare con / o -, in maiuscolo o minuscolo. Se DDM è in esecuzione, riceve il comando; altrimenti, DDM si avvia e lo esegue. Per esempio:
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
Viene fornito con ogni download di DDM, accanto all'app (il programma di installazione lo mette nella cartella di DDM). Funziona da solo: l'app non deve essere in esecuzione, eccetto per status e api.
| Comando | Cosa fa |
|---|---|
get URL [-o folder\|file] [-c connections] [-H "Header: value"]... [--checksum hash] [--dns choice] [--adapter name] |
Scarica un file con un massimo di 8 connessioni (-c, da 1 a 128) e mostra l'avanzamento. Ctrl+C lo mette in pausa; resume lo riprende. --checksum verifica il file scaricato: calcola l'hash MD5, SHA-1, SHA-256, SHA-512 o CRC32, con un nome opzionale (sha256:…). --dns sceglie il DNS: system (quello predefinito); un servizio e il metodo per interrogarlo, cloudflare-https, quad9-tls, google-plain, adguard-https, nextdns-tls; gli indirizzi dei server DNS, 9.9.9.9,149.112.112.112; oppure un indirizzo DNS-over-HTTPS. Non ripiega mai sul DNS di sistema. --adapter instrada ogni connessione attraverso una scheda di rete specifica, scelta per nome (Ethernet, wg0) o per uno dei suoi indirizzi. Se la scheda non è connessa, non viene inviato nulla e il download non riesce. I collegamenti a un file hosting supportato da uno dei tuoi account debrid (Opzioni → Account) passano attraverso quell'account, come nell'app. get indica through Real-Debrid; --direct scarica direttamente l'indirizzo (Account del servizio debrid). |
resume file.mdm.json [-c connections] [-H ...] [--direct] |
Riprende un download in pausa o interrotto dal file .mdm.json che si trova accanto. Con un account debrid, funziona come get: se il vecchio collegamento è scaduto, il servizio ne fornisce uno nuovo; --direct riprende direttamente dall'indirizzo. |
install-gallery-dl |
Installa o aggiorna gallery-dl, il programma per scaricare gallerie di immagini. Il suo elenco dei checksum viene verificata con la chiave di firma dell'autore e il programma viene verificato con quell'elenco (Windows e Linux x86-64; sugli altri sistemi, installalo tu). |
gallery-get URL [-o folder] [--limit N] [-c N] [--adapter name] |
Scarica le immagini di una galleria (una categoria di Wikimedia Commons, un album di Flickr, ...) in una cartella con il suo nome dentro -o: gallery-dl le elenca, il downloader di DDM le scarica, -c alla volta (8 per impostazione predefinita, come le connessioni di get); --limit ne prende al massimo quel numero, le prime elencate dal sito. Se avviato di nuovo, scarica solo quelle nuove. --adapter fa passare le sue connessioni, e quelle di gallery-dl, da una sola scheda di rete, come per get. |
video-info URL |
Indica quali video contiene una pagina (YouTube, Vimeo, ...) e le qualità disponibili. |
playlist-info URL [--from N] [--count N] |
Elenca i video di una playlist o di un canale, uno per riga nell'ordine in cui appaiono: posizione, durata, titolo e indirizzo. |
playlist-get URL [-f selector] [-o folder] [-c pieces] [--from N] [--count N] |
Scarica i video di una playlist o di un canale uno dopo l'altro, in una cartella con il nome della lista all'interno di -o. -f è una qualità per tutti, come per video-get (per impostazione predefinita la migliore di ogni video; bv*[height<=720]+ba/b[height<=720] = fino a 720p; ba = il suono originale; mp3:320, opus:, flac: come per video-get). -c come per video-get. |
video-get URL [-f selector] [-o folder] [-c pieces] [--subs langs] [--auto-subs] [--embed-subs] [--adapter name] |
Scarica un video; -f prende un selettore di qualità da video-info (b = il miglior file singolo; ba = solo l'audio come fornito dal sito, non convertito; mp3:320, mp3:256, mp3:192 o mp3:128 = l'audio come MP3 a quel bitrate, mp3:0 al suo miglior bitrate variabile; opus: = come Opus; flac: = come FLAC, senza perdita ma non migliore dell'audio del sito; le conversioni richiedono ffmpeg). -c: il downloader di DDM scarica ogni stream trovato da yt-dlp usando questo numero di connessioni (8 per impostazione predefinita, da 1 a 128), e uno stream in pezzi (HLS, DASH) con questo numero di pezzi alla volta. --subs salva i sottotitoli accanto al video: codici lingua da video-info (en,fr), o all per tutti quelli forniti dall'uploader; --auto-subs prende invece i sottotitoli automatici del sito; --embed-subs li inserisce nel video (richiede ffmpeg, MP4 o MKV). --adapter invia le connessioni dei download, e quelle di yt-dlp (e ffmpeg), attraverso una scheda di rete, come per get; quando non è connessa, nulla si avvia. |
install-ytdlp, install-ffmpeg |
Installa o aggiorna i programmi di supporto necessari per i video: yt-dlp (verificato con la sua chiave di firma) e ffmpeg (su Windows; su macOS e Linux DDM usa quello del sistema). |
torrent-info SOURCE |
Nome, file (numerati) e dimensione di un torrent; SOURCE è un link magnet o un file .torrent. |
torrent-get SOURCE [-o folder] [--files 0,2] [--use-existing] |
Scarica un torrent o solo alcuni dei suoi file. Se alcuni sono già nella cartella, il comando si interrompe e li elenca; --use-existing li usa invece (i file corrispondenti vengono mantenuti, gli altri scaricati). |
torrent-create PATH -o file.torrent |
Crea un .torrent da un file o da una cartella (i peer lo trovano tramite la DHT). |
status |
I download dell'app in esecuzione, in formato JSON, con i relativi ID (l'API di automazione deve essere attiva). |
pause ID..., start ID... |
Mette in pausa i download in corso oppure avvia (riprende) quelli interrotti, in coda o non riusciti nell'app in esecuzione. |
remove ID..., delete ID... |
Rimuove i download dall'elenco dell'app in esecuzione: remove mantiene i relativi file, delete li elimina. Prima mette in pausa i download in corso (pause). |
api on, api off |
Attiva o disattiva l'API di automazione dell'app in esecuzione. |
dannexdownloadmanager-cli help <command>mostra tutte le opzioni. Se un comando non riesce (l'app non è in esecuzione, risponde con un errore o un download si interrompe), termina con il codice 1. Per esempio:
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 per script e programmi
Con --json (prima o dopo il comando), ogni comando stampa JSON anziché testo, con un oggetto per riga, così che script e agenti AI possano leggerlo:
| Comando | Cosa stampa |
|---|---|
get, resume |
{"event": "through", "service"}prima, se il download passa attraverso un account debrid, poi una riga {"event": "progress", "downloaded", "size", "speed", "connections", "segments"} ogni mezzo secondo, poi {"event": "done", "path", "size", "seconds"} oppure {"event": "paused", "state"} dopo Ctrl+C (state è il file usato da resume). |
video-get |
{"event": "progress", "downloaded", "size", "speed"}righe, poi {"event": "done", "path", "subtitles", "subtitle_problems"}: i file dei sottotitoli salvati accanto al video e le lingue rifiutate dal sito ({"code", "name", "reason", "beside"}; beside: i sottotitoli sono stati scaricati al secondo tentativo, accanto al video anziché al suo interno). |
torrent-get |
{"event": "progress", "phase", "downloaded", "size", "speed", "peers", "peers_seen"}righe, poi {"event": "done", "path", "size"}, o {"event": "stopped", "downloaded", "seconds"} con --seconds. |
video-info |
{"title", "choices": [{"label", "format", "size"}], "subtitles": [{"code", "name", "automatic"}]}; format di una scelta indica cosa usa video-get -f, mentre code di un sottotitolo indica cosa usa --subs. |
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 |
La risposta dell'app, già in formato JSON (vedi sotto). |
Le dimensioni sono espresse in byte (null se sconosciute), la velocità in byte al secondo. In caso di errore stampa {"error": "…"} e termina con il codice 1. Per esempio:
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}
L'API di automazione
Altri programmi possono chiedere all'app in esecuzione cosa sta scaricando e mettere in pausa, avviare, rimuovere o eliminare i download. L'API è disattivata per impostazione predefinita; attivala con dannexdownloadmanager-cli api on (e disattivala con api off).
Come comunica un programma con DDM
- Mentre è in esecuzione, DDM ascolta su una porta di
127.0.0.1(solo su questo computer) e salva la porta e un token segreto nel fileipc.jsonnella cartella dei dati: - Windows:%APPDATA%\dannexdownloadmanager\ipc.json- macOS:~/Library/Application Support/dannexdownloadmanager/ipc.json- Linux:~/.local/share/dannexdownloadmanager/ipc.json- Una copia portatile:data\ipc.jsonaccanto al programma.
Il token cambia a ogni avvio; solo i programmi che possono leggere la tua cartella dati possono usarlo. 2. Connettiti a quella porta e invia una riga JSON con il token e i campi del comando, ad esempio {"token": "<token>", "query": "list"}. 3. DDM risponde con una riga: ok per un comando oppure un oggetto JSON per una richiesta.
Cosa supporta
Campi (oltre a token) |
Risposta |
|---|---|
{"query": "list"} |
Ogni download e la velocità totale: {"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 è Queued, Downloading, Stopped, Complete o Error; size è null se sconosciuto; error (perché non è riuscito) è presente solo per un download in Error; category è il key di una categoria; free è lo spazio libero dove vanno i download (null se sconosciuto). Solo con l'API attiva. |
{"action": "pause", "ids": [3, 4]} |
Agisce sui download in base all'id: "pause", "start", "remove" (file conservato), "delete" (elimina anche il file) o "folder" (mostra il file nella sua cartella, come fa Apri cartella). Risponde {"done": [3], "skipped": [{"id": 4, "why": "not running"}]}; un download in corso va messo in pausa prima di essere rimosso o eliminato. Solo quando l'API è attiva. |
{"action": "start_queue", "queue": "Main download queue"} |
Avvia (o con "stop_queue", interrompe) la coda con quel nome (un nome preso da queues dell'elenco). Risponde {"done": [], "skipped": []}, o {"error": …, "code": "unknown-queue"}. Solo con l'API attiva. |
{"api": true} / {"api": false} |
Attiva o disattiva l'API: {"api": true}. |
{"url": "https://…", "dir": "D:\\Files", "name": "a.zip", "silent": true} |
Aggiunge un download, come fanno le opzioni /d /p /f /n della riga di comando ("later": true è /a); ok. "category" (una chiave presa da categories dell'elenco) lo inserisce nella cartella di quella categoria invece di quella scelta dal suo tipo; "queue" (il nome di una coda) è la coda in cui attende con "later". Anche con l'API disattivata, come la riga di comando. |
{"start_queue": true} |
Avvia la coda di download principale; ok. |
Una domanda o azione sconosciuta riceve risposta {"error": "…"}, così come una domanda mentre l'API è disattivata (in quel caso con "code": "api-off", che i programmi possono controllare: il testo dell'errore potrebbe cambiare). Un token errato riceve risposta denied.
Il pulsante della barra degli strumenti dell'estensione per il browser elenca i download di DDM con lo stesso list, e mette in pausa, riprende e apre le loro cartelle con le stesse azioni, qualunque sia l'interruttore dell'API: il suo programma di supporto contrassegna ciò che chiede con "browser": true. Non chiede nient'altro in questo modo.
Ogni richiesta e risposta è descritta, campo per campo, in uno schema JSON: automation-api.schema.json (anche su https://dannex.kavangi.co.ke/automation-api.schema.json). È generato dal codice con cui l'app risponde, quindi resta sempre esatto; i programmi possono usarlo per verificare ciò che inviano e leggono, o per generare i propri tipi.
Esempi
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"])
Per aggiungere un download, invia {"token": "…", "url": "https://example.com/a.zip", "silent": true}.
Gratuito, open source, senza pubblicità, senza periodo di prova.
Scarica Dannex Download Manager