How Matt Download Manager's pieces fit together.
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 (mattdownloadmanager.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 (mattdownloadmanager --cli …), e mattdownloadmanager-cli, un piccolo launcher che la avvia con gli stessi argomenti, terminale e codice di uscita |
crates/mcp |
mdm-mcp |
Il server MCP (mattdownloadmanager-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, Mega-Debrid) trasformano un collegamento di un file hosting in un collegamento diretto che il motore scarica |
crates/cnl |
mdm-cnl |
Click'n'Load 2 (#37): il listener su 127.0.0.1:9666 che legge i post di un sito di collegamenti e li trasforma in pacchetti per il Link grabber, con limiti su ciò che accetta |
crates/extract |
mdm-extract |
Archive extraction (#37): zip, tar, gz and xz in process; 7z and RAR through an installed 7-Zip, run as its own program; in place through HatchZip when asked |
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 |
Le pagine video tramite yt-dlp e ffmpeg, le gallerie di immagini tramite gallery-dl (eseguiti come programmi separati); quando è selezionata una scheda di rete, le loro connessioni passano attraverso un proxy di MDM su 127.0.0.1 che le lega ad essa (relay.rs); ognuno viene eseguito in una cartella in cui può scrivere, anche la sua TEMP (workdir.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/ |
— | https://idm.teachermatt.com's own pages (home, download, features, themes, FAQ); tools/website/build.py adds the help from docs/ and the news from the CHANGELOG, in 22 languages, and GitHub Pages publishes it |
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.
A download's first request (get) follows redirects and the pages that lead on to a file by
themselves (a waiting page's refresh). Sites whose links aren't the file's address have a module
in sites/ (Google Drive: sites/gdrive.rs; MediaFire: sites/mediafire.rs): it turns the link
into the file's address, reads the site's own pages (a confirmation form, a download button, an
error page), names its refusals (Error::Refused) and, where the file's addresses expire, the
page that gives a fresh one (sites::origin, asked again when a connection meets an expired
address), with pure functions tested without a network. The lab server plays such a site on its
real host names for the end-to-end tests (labserver/src/drive.rs, labserver/src/mediafire.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
One egui window painted to fixed pixel coordinates, plus one immediate viewport per dialog.
app.rs holds the state (downloads, queues, settings, the list's selection) and turns menu,
toolbar, key and IPC commands into actions. Each dialog is its own module and returns an
Outcome (open, closed, done with a value). Windows-only calls are confined to win32.rs and
their Linux and macOS counterparts to unix.rs (starting with the session, the browsers' host,
sounds, show in folder, the crash handler); every other file is safe, portable Rust. Fonts come from the system:
Windows' Fonts folder, macOS's system fonts, fontconfig on Linux (theme.rs). The interface language's
script fonts load at start; text in another script gets its font the first time it shows: from MDM's
lists of the system's fonts for each script, then, on Windows and macOS, from the system's own fallback
(DirectWrite's, CoreText's, through fontique: egui_system_font_provider) for what the lists don't
name; Linux asks fontconfig for any letter. On Windows, Latin,
Greek, Cyrillic and single-codepoint CJK text is drawn by DirectWrite (win32.rs, through egui's glyph rasterizer hook):
View → Text → Smooth in its natural mode, anti-aliased at the size asked for and placed at quarter
pixels with the font's own advances; Classic (the default) in GDI-classic mode, so each letter's
hinted shape and whole-pixel width come together. CJK uses the interface language's system face;
combining marks, multi-codepoint clusters and missing glyphs stay with egui, as do other scripts.
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.rsdichiara 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 tramitetheme::colors()etheme::metrics()e decidono gli stati di ogni controllo da essi; nessun codice di disegno contiene un colore proprio. - Palette derivate.
derive.rscrea 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.rsricava 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::Controlsnomina 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 MDM disegna poi la barra del titolo stessa (i ruolicaption.*). - File dei temi.
themefile.rslegge TOML o JSON dalla cartella dei datithemes(un file, o<id>/theme.tomlcon icone accanto). Un file nomina solo ciò che cambia; il resto proviene dal tema cheinherits(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.rsdisegna 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-symboliccolorate con il colore del testo) dove l'aspetto classico disegna le proprie; dove il set non ha un'icona, resta quella classica.
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 (MDM 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%\mattdownloadmanager\ su Windows, ~/.local/share/mattdownloadmanager su Linux, ~/Library/Application Support/mattdownloadmanager 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 MDM) 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.
A message to the host is at most 1 MB (mdm_ipc::MAX_MESSAGE; the host refuses more, and the
browser lets a host answer no more than that either). A page's links past it go in parts, each
measured as the widest browser writes it (wireSize in background.js) and carrying the page's
referrer and cookies and its place (mdm_ipc::LinksPart); the host hands each over as it comes,
and the app keeps them (linkparts.rs) until the last is in, then opens Link grabber with the
whole list.
L'host serve solo l'estensione di MDM. 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
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 MDM 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/.
Gratuito, open source, senza pubblicità, senza periodo di prova.
Scarica Matt Download Manager