Dannex Download Manager
  1. Home
  2. Guida
  3. Architettura

Architettura

Come si integrano le parti di Dannex Download Manager.

Crates

Percorso Crate Ruolo
crates/engine mdm-engine Scarica un file tramite HTTP(S) o FTP(S): sonda, pianificatore dei segmenti, worker di connessione, stato di ripresa, limiti per host, limitatore di velocità, checksum, script proxy
crates/app mdm-app L'app desktop (dannexdownloadmanager.exe, egui): elenco, categorie, code, Pianificatore, finestre, area di notifica, impostazioni
crates/cli mdm-cli Download senza interfaccia utente con avanzamento (get, resume), video, torrent e i comandi dell'API di automazione: una libreria eseguita dal programma dell'app (dannexdownloadmanager --cli …), e dannexdownloadmanager-cli, un piccolo launcher che la avvia con gli stessi argomenti, terminale e codice di uscita
crates/mcp mdm-mcp Il server MCP (dannexdownloadmanager-mcp): gli assistenti AI elencano, aggiungono e gestiscono i download dell'app in esecuzione tramite l'API di automazione
crates/remote mdm-remote Il controllo remoto (#141): il server HTTPS usato da un telefono o computer associato sulla rete locale (la sua pagina, i codici di associazione, i token del dispositivo, il certificato autofirmato); ogni richiesta diventa un comando API di automazione a cui l'app risponde
crates/nmhost mdm-nmhost L'host di messaggistica nativa del browser: riceve i download acquisiti dall'estensione e li passa all'app
crates/ipc mdm-ipc Il canale a istanza singola (un socket locale protetto da token), la cartella dei dati e le regole di acquisizione condivise dall'app e dall'host
crates/debrid mdm-debrid Account Debrid (#44): le API ufficiali dei servizi (Real-Debrid, AllDebrid, Premiumize, TorBox) trasformano un link di un file hosting in un link diretto che il motore scarica
crates/extract mdm-extract Estrazione degli archivi (#37): zip, tar, gz e xz all'interno del processo; 7z e RAR tramite un 7-Zip installato, eseguito come programma separato
crates/geo mdm-geo Posizione del server di un download (#140): una tabella di intervalli da IP a paese creata dai dati Lite di DB-IP (tools/geo/build.py), consultata solo su questo computer, e le bandiere dei paesi
crates/tools mdm-tools Pagine video tramite yt-dlp e ffmpeg, gallerie di immagini tramite gallery-dl (eseguiti come programmi separati); quando viene scelta una scheda di rete, le loro connessioni passano attraverso un proxy di DDM su 127.0.0.1 che le vincola a quella scheda (relay.rs)
crates/crash mdm-crash Rapporti di arresti anomali e blocchi: il processo di monitoraggio, minidump esterni al processo, stack con simboli, il testo del rapporto e i log della release (crash-reports.md)
crates/torrent mdm-torrent BitTorrent e link magnet tramite librqbit
crates/labserver mdm-labserver Un server HTTP Range con un log delle richieste e iniezione di errori, e un server FTP/FTPS con errori propri, per test e benchmark
extension/ — L'estensione per Chromium (MV3) e Firefox
docs/ — La guida per l'utente e i tutorial, questo file e i dati di benchmark; il sito web usa la guida come pagine della guida, aperte da Guida
website/ — Le pagine di dannex.kavangi.co.ke (home, download, funzionalità, temi, FAQ); tools/website/build.py aggiunge la guida da docs/ e le notizie dal CHANGELOG, in 22 lingue, e GitHub Pages le pubblica

Le dipendenze puntano verso l'interno: app, cli, mcp, nmhost e remote usano engine e ipc; il motore non sa nulla dell'interfaccia utente. L'app vede il motore solo attraverso i suoi eventi (avanzamento, istantanee della tabella dei segmenti, completato, non riuscito).

Motore

Download
 ├─ probe()              size, resumable?, validators (ETag / Last-Modified), file name
 ├─ Planner (pure)       segment table: when a connection is free, the largest remaining
 │                       part is split in half (planner.rs, tested by random simulation)
 ├─ Worker × N           one HTTP/1.1 connection each, reused across segments; slow ones
 │                       are dropped and their part re-split
 │    └─ writes at its offset into <name>.mdm.part (created sparse)
 ├─ HostLimits           learns how many connections each server accepts
 ├─ Limiter (shared)     per-download and global token buckets
 ├─ State                segment table saved atomically (craft-atomic) for crash-safe resume
 └─ events → channel     Progress, Done, Failed

Quando tutti i segmenti sono completati, il file parziale viene verificato rispetto alla dimensione prevista e rinominato nella posizione finale; la data del file può seguire quella del server.

La prima richiesta di un download (get) segue i reindirizzamenti e le pagine che portano direttamente a un file (l'aggiornamento automatico di una pagina di attesa). I siti i cui collegamenti non puntano all'indirizzo del file hanno un modulo in sites/ (Google Drive: sites/gdrive.rs): trasforma il collegamento nell'indirizzo del file, legge le pagine del sito (un modulo di conferma, una pagina di errore) e descrive i rifiuti del sito (Error::Refused), usando funzioni pure testate senza connessione. Per i test end-to-end, il server di laboratorio riproduce un sito simile usando i suoi nomi host reali (labserver/src/drive.rs).

FTP e FTPS (ftp.rs) usano lo stesso pianificatore, gli stessi worker e lo stesso stato: un segmento è REST + RETR su una sessione di controllo invece di un GET con intervalli; SIZE e MDTM sostituiscono le intestazioni, e le sessioni vengono raggruppate per download e riutilizzate tra i segmenti.

App

Una finestra egui disegnata con coordinate fisse in pixel, più una viewport immediata per ogni finestra. app.rs contiene lo stato (download, code, impostazioni, la selezione dell'elenco) e trasforma i comandi di menu, barra degli strumenti, tastiera e IPC in azioni. Ogni finestra è un modulo a sé stante e restituisce un Outcome (aperta, chiusa, completata con un valore). Le chiamate solo per Windows sono confinate a win32.rs e le loro controparti Linux e macOS a unix.rs (a partire dalla sessione, l'host dei browser, i suoni, mostra nella cartella, il gestore degli arresti anomali); ogni altro file è Rust sicuro e portatile. I font provengono dal sistema: la cartella Fonts di Windows, i font di sistema di macOS, fontconfig su Linux (theme.rs). Su Windows, il testo latino, greco e cirillico è disegnato da DirectWrite (win32.rs, tramite l'hook del rasterizzatore di glifi di egui): Visualizza → Testo → Uniforme nella sua modalità naturale, con anti-aliasing alla dimensione richiesta e posizionato a quarti di pixel con gli avanzamenti del font; Classico (l'impostazione predefinita) in modalità GDI-classic, in modo che la forma suggerita di ogni lettera e la larghezza a pixel interi si uniscano. Altri script sono modellati e disegnati da egui.

Temi

Ogni colore e dimensione con cui viene disegnato un controllo deriva dal tema attivo (#45). Un tema è una palette chiara e una scura, metriche, stili dei controlli e uno stile delle icone (palette.rs):

  • Ruoli della palette. palette.rs dichiara ogni ruolo con una chiave stabile ("button.hot", "list.row", "caption"…), una descrizione e i valori chiari e scuri dell'aspetto classico, scritti esplicitamente (l'aspetto classico non è derivato). I painter condivisi (winui.rs, chrome.rs, list.rs, scrollbar.rs) li leggono tramite theme::colors() e theme::metrics() e decidono gli stati di ogni controllo da essi; nessun codice di disegno contiene un colore proprio.
  • Palette derivate. derive.rs crea un'intera palette da pochi semi (sfondo, superficie, testo, colore principale…), mescolando ogni altro ruolo in OKLab e mantenendo il contrasto WCAG (4,5:1 per il testo, 3:1 per i bordi); Contrasto elevato rafforza inoltre tutti i bordi. native.rs ricava i semi del tema Nativo dal colore principale e dal contrasto del sistema (impostazioni di Windows, il portale freedesktop su Linux, il colore principale di macOS).
  • Stili dei controlli. palette::Controls nomina la forma di ogni controllo (caselle di testo, caselle di selezione, pulsanti, barre di avanzamento, barre di scorrimento, il segno di messa a fuoco, la barra del titolo); i temi di stile (Metro, Adwaita, Breeze, Luna, Aero, Aqua, Smeraldo) scelgono i loro, e su Windows DDM disegna poi la barra del titolo stessa (i ruoli caption.*).
  • File dei temi. themefile.rs legge TOML o JSON dalla cartella dei dati themes (un file, o <id>/theme.toml con icone accanto). Un file nomina solo ciò che cambia; il resto proviene dal tema che inherits (l'ID di un tema integrato o un altro file, l'aspetto classico per impostazione predefinita), lungo una catena in cui i cicli vengono rifiutati. Le chiavi sconosciute sono avvisi, non errori. I temi di stile integrati sono anch'essi tali file, inclusi nel programma (crates/app/assets/themes).
  • Set di icone. themeicons.rs disegna le icone di un tema (nominate in base al loro scopo: tb-add-url, cat-music…, SVG o PNG a 16, 24, 32 e 48 px, quelle -symbolic colorate con il colore del testo) dove l'aspetto classico disegna le proprie; dove il set non ha un'icona, resta quella classica.
  • Stili delle icone della barra degli strumenti. Visualizza → Barra degli strumenti → Stile a linee (i contorni, colorati come stabilisce il tema) o Stile 3D: le immagini lucide di DDM (assets/icons/toolbar3d, disegnate da tools/icon/toolbar_3d.py da 16 a 64 px, quella adatta alla dimensione sullo schermo; in grigio da icons.rs quando il pulsante è disattivato). Valgono dove il tema non ha un'icona propria per un pulsante e dove colora le icone con i propri colori; un tema con un set di icone, o che colora le icone con un solo colore (Contrasto elevato), mantiene le sue.

La disposizione dei controlli di una finestra resta il suo layout. Lo stesso vale per le icone prima dei nomi dei file (fileicons.rs): gli elenchi di immagini di sistema della shell di Windows, quelli del Finder di macOS (NSWorkspace), il tema delle icone del desktop Linux (xdgicons.rs, shared-mime-info e la Icon Theme Specification). Ogni tipo viene cercato una volta per dimensione in pixel, su un thread in background. Le icone di Tango (incluse) vengono usate finché l'icona del sistema non è pronta, e ovunque il sistema non ne abbia.

Disegno

Le finestre vengono disegnate con OpenGL (glow di eframe) o con l'API grafica del sistema tramite wgpu di eframe, con un solo backend: Direct3D 12 su Windows (l'impostazione predefinita), Vulkan su Linux, Metal su macOS (scelte disponibili; OpenGL resta l'impostazione predefinita finché le schede grafiche reali non li avranno provati, #206). Visualizza → Rendering con ne seleziona uno, dal prossimo avvio. Un unico percorso di codice lo fa su ogni sistema (crates/app/src/renderer.rs): quando quello scelto non può avviarsi, viene provato l'altro, così le finestre si aprono sempre. Un avvio monitorato con l'API del sistema lascia un marcatore finché non viene disegnato il suo primo fotogramma: un avvio che termina prima (un arresto anomalo nel driver), uno il cui primo fotogramma non arriva entro 10 secondi (DDM si riavvia quindi con OpenGL), o una scheda grafica persa due volte in 10 minuti: ogni caso viene memorizzato con il suo motivo, che il menu mostra.

Visualizza → Dimensioni interfaccia (scale.rs, #262) è il fattore di zoom di egui sulla scala del display: ogni finestra è disposta in punti, quindi si apre ingrandita di altrettanto; una finestra più grande dello schermo si può scorrere.

Dati

L'elenco dei download e le impostazioni vengono salvati atomicamente nella cartella dei dati (downloads.json): %APPDATA%\dannexdownloadmanager\ su Windows, ~/.local/share/dannexdownloadmanager su Linux, ~/Library/Application Support/dannexdownloadmanager su macOS, una cartella data accanto a una copia portatile, o MDM_DATA_DIR (mdm_ipc::data_dir). L'host del browser legge lo stesso file per le regole di acquisizione, quindi una modifica in Opzioni si applica al prossimo download acquisito.

I segreti di accesso (account debrid, password degli Accessi ai siti e del proxy) risiedono nel portachiavi del sistema (secrets.rs, #44): Gestione credenziali di Windows (win32.rs), il Secret Service su Linux o il portachiavi di macOS (unix.rs). Le impostazioni mantengono un riferimento keychain:<service>/<scope>/<key> al loro posto, scritto solo una volta che il portachiavi ha confermato il segreto; senza un portachiavi (o con uno bloccato, mai sbloccato per DDM) il segreto resta nelle impostazioni come prima.

La posizione del server di un download (#140) è il paese dell'indirizzo a cui si è connesso, cercato nella tabella di mdm-geo su questo computer (countries.rs lo nomina nella lingua dell'interfaccia); il job di release ricostruisce la tabella dai dati del mese (tools/geo/build.py --release).

Integrazione con i browser

page ──► extension ──native messaging──► mdm-nmhost ──ipc──► app

L'estensione chiede all'host quali tipi di file prendere, verifica ogni download rispetto a essi e annulla il download del browser solo dopo che l'app lo ha accettato; altrimenti il browser lo mantiene e l'estensione ne spiega il motivo.

La stessa risposta contiene i tasti di Opzioni → Generale (keys: i tasti con cui page.js riconosce un clic, per lasciare un collegamento al browser o forzarlo all'app) e le voci del menu del clic destro da mostrare (menu: background.js ricrea il suo menu quando cambiano); la risposta sulla possibilità di mostrare il pulsante video contiene le impostazioni dei Pannelli di download (panel: sopra i video o i lettori audio, la durata minima, l'angolo iniziale). I loro nomi e valori predefiniti sono quelli di mdm_ipc::capture, letti dalle impostazioni che l'app salva. L'estensione chiede di nuovo quando la finestra del browser torna in primo piano (pochi secondi dopo l'ultima richiesta), quando si apre una pagina (15 s) e quando parte un download (un minuto).

L'elenco dei download nel popup della barra degli strumenti (Pausa, Riprendi, Apri cartella) e il numero sul pulsante sono list e azioni dell'API di automazione, richiesti tramite l'host con browser impostato: l'app risponde a queste richieste qualunque sia l'interruttore dell'API, come risponde al menu della qualità del pulsante video, e l'host non avvia mai l'app per questo. L'estensione chiede solo mentre il popup è aperto o ci sono download in corso.

L'host serve solo l'estensione di DDM. I suoi ID sono in un unico posto, mdm_ipc::extension (crates/ipc/src/extension.rs): quello della copia non compressa (UNPACKED_ID, dalla chiave pubblica del manifest), quello del Chrome Web Store (STORE_ID, firmato con la chiave dello store: pack.ps1 omette la chiave del manifest dalla copia dello store), quello del componente aggiuntivo di Firefox (FIREFOX_ID) e la sua pagina addons.mozilla.org; quelli degli store di Edge e Opera sono segnaposto, mai serviti, finché l'estensione non sarà elencata lì. L'host scrive il manifest di ogni browser con quegli ID, e l'app propone la copia dello store (Aggiungi a Chrome, Aggiungi a Firefox) prima di quella non compressa.

Controllo remoto

phone ──HTTPS (paired token)──► mdm-remote ──ipc::Sink──► app (answer, remote_add)

--headless(headless.rs, #157) esegue lo stesso App senza eframe: un ciclo chiama il suo tick (ciò che logic esegue a ogni fotogramma) su un semplice egui::Context, risvegliato dal canale di comando, e mai il suo ui; i comandi vengono aggiunti come li aggiunge il controllo remoto (nessuna finestra). I Dockerfile e docker/ (Compose, il template di Unraid) lo eseguono su un server (server.md).

Il server viene eseguito sul runtime Tokio dell'app, un listener per ogni indirizzo di rete locale. Ogni richiesta viene controllata (Host, Origin, token), trasformata in un mdm_ipc::Command contrassegnato remote (un campo che nessuna riga di richiesta può impostare) e consegnata all'app tramite lo stesso canale della riga di comando; l'app risponde ad essa al fotogramma successivo, come risponde all'API di automazione. La sua pagina è integrata (crates/remote/web) e i suoi testi provengono dai cataloghi dell'app (remote.rs).

Traduzioni

Ogni testo mostrato dall'interfaccia utente passa attraverso crate::i18n (cataloghi craft-i18n, i18n/<locale>.tsv). tools/i18n/extract.py ricostruisce i18n/en.tsv dalla sorgente, con una nota per i traduttori su ogni testo (cos'è, dove appare, i suoi segnaposto). tools/i18n/translate.py completa ciò che manca agli altri cataloghi (righe contrassegnate #, machine), seguendo la guida di stile di ogni lingua (i18n/style/) e il glossario; una riga revisionata da una persona non viene mai sostituita, e la CI (reviewed_guard.py) blocca una modifica che ne elimini una. Il sito web ha i suoi cataloghi (i18n/site/, tools/website/translate_site.py).

Immagini

L'icona dell'app è disegnata a partire dalla geometria (tools/icon/dannex_logo.py; build_icon.py scrive ogni dimensione, posizionata a mano su pixel interi da 16 a 48 px). Ogni punto che la mostra prende il disegno adatto alla sua dimensione sullo schermo (logo.rs): su Windows le icone della barra del titolo e della barra delle applicazioni di ogni finestra alla scala del suo schermo (win32::crisp_icons, che le mantiene anche quando la finestra passa a un altro schermo), quella dell'area di notifica alla scala della barra delle applicazioni. Visualizza → DDM Icona nell'area di notifica la mostra a colori pieni (Stile 3D) o solo il simbolo con il colore della barra delle applicazioni (Stile piatto: bianco su una barra scura, scuro su una chiara; un'immagine modello su macOS), con una sottile barra alla base mentre i download sono in corso.

Le immagini delle pagine della guida (docs/images/help/) provengono da un unico elenco, tools/shots/shots.toml: tools/shots/make.py apre ogni finestra tramite il comando da riga di comando /show <window> di DDM in un'istanza di test fuori schermo, la ritaglia e la annota dall'albero di accessibilità della finestra, e scrive WebP senza perdita di dati; make.py check (CI) mantiene l'elenco, le pagine e i file sincronizzati. Quelle pubblicate sono prese sul runner di Windows di GitHub (docs-shots.yml).

Collaboratori

tools/contributors.pylegge chi ha aperto pull request e issue, e chi ha commentato, dall'API pubblica di GitHub (il maintainer, Claude e i bot sono esclusi) per ogni sezione che li ringrazia: la home page del sito web, /contributors.html e ogni release nella pagina Novità (build.py, su ogni build), le note di ogni release (release.yml, le persone attive dalla release precedente) e il README (python tools/contributors.py readme alla preparazione di ogni release: le sue foto rotonde sono incluse nel commit in art/contributors/, poiché GitHub non può arrotondare un'immagine in un README).

Test e benchmark

cargo testesegue test unitari e download end-to-end contro mdm-labserver con errori iniettati (connessioni lente, interrotte e rifiutate, server che non supportano le richieste per intervalli, file che cambiano). tools/bench esegue il confronto di velocità pubblicato; i suoi dati grezzi si trovano in docs/bench/.

I fotogrammi delle finestre sono misurati, non stimati (crates/app/src/framestats.rs): MDM_FRAME_STATS=1 registra nel log, ogni secondo, le passate di disegno della finestra principale, quante derivano da input, quanto costano (la finestra principale, le finestre di avanzamento, la loro disposizione) e quali righe di codice hanno richiesto le altre; MDM_SYNTHETIC_LIST=10000 (con un MDM_DATA_DIR temporaneo) aggiunge tante righe inventate; MDM_BENCH_SCROLL=10 fa scorrere l'elenco da solo per dieci secondi e registra i tempi dei fotogrammi. Una finestra inattiva non ha fotogrammi tranne quelli del suo orologio (uno ogni 2 s); l'elenco disegna solo le righe visibili.

Gratuito, open source, senza pubblicità, senza periodo di prova.

Scarica Dannex Download Manager