Dannex Download Manager
  1. Home
  2. Guida
  3. Riga di comando e automazione

Riga di comando e automazione

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

  1. 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 file ipc.json nella 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.json accanto 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