1. Startseite
  2. Hilfe
  3. Architektur

Architektur

How Matt Download Manager's pieces fit together.

Crates

Pfad Crate Rolle
crates/engine mdm-engine Lädt eine Datei über HTTP(S) oder FTP(S) herunter: Probe, Segmentplaner, Verbindungs-Worker, Wiederaufnahmezustand, Host-spezifische Limits, Geschwindigkeitsbegrenzer, Prüfsummen, Proxy-Skripte
crates/app mdm-app Die Desktop-App (mattdownloadmanager.exe, egui): Liste, Kategorien, Warteschlangen, Scheduler, Dialoge, Tray, Einstellungen
crates/cli mdm-cli Downloads ohne grafische Oberfläche mit Fortschritt (get, resume), Videos, Torrents und die Befehle der Automatisierungs-API: eine Bibliothek, die das Programm der App ausführt (mattdownloadmanager --cli …), und mattdownloadmanager-cli, ein kleiner Launcher, der sie mit denselben Argumenten, Terminal und Exit-Code startet
crates/mcp mdm-mcp Der MCP-Server (mattdownloadmanager-mcp): KI-Assistenten listen die Downloads der laufenden App auf, fügen sie hinzu und steuern sie über die Automatisierungs-API
crates/remote mdm-remote Fernzugriff (#141): der HTTPS-Server, den ein gekoppeltes Telefon oder ein Computer im lokalen Netzwerk verwendet (seine Seite, Kopplungscodes, Gerätetoken, das selbstsignierte Zertifikat); jede Anfrage wird zu einem Automatisierungs-API-Befehl, den die App beantwortet
crates/nmhost mdm-nmhost Der native Messaging-Host des Browsers: nimmt erfasste Downloads von der Erweiterung entgegen und übergibt sie an die App
crates/ipc mdm-ipc Der Single-Instance-Kanal (ein Token-geschützter lokaler Socket), der Datenordner und die Erfassungsregeln, die von der App und dem Host gemeinsam genutzt werden
crates/debrid mdm-debrid Debrid-Konten (#44): Die offiziellen APIs der Dienste (Real-Debrid, AllDebrid, Premiumize, TorBox, Mega-Debrid) wandeln einen Link eines Filehosters in einen direkten Link um, den die Engine herunterlädt.
crates/cnl mdm-cnl Click'n'Load 2 (#37): Der Listener auf 127.0.0.1:9666, der die Beiträge einer Link-Seite in Pakete für den Link-Grabber liest, mit Beschränkungen, was er übernimmt.
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 Wo sich der Server eines Downloads befindet (#140): eine IP-zu-Land-Bereichstabelle, erstellt aus DB-IPs Lite-Daten (tools/geo/build.py), nur auf diesem Computer nachgeschlagen, und die Flaggen der Länder.
crates/tools mdm-tools Videoseiten über yt-dlp und ffmpeg, Bildergalerien über gallery-dl (als separate Programme ausgeführt); während ein Netzwerkadapter ausgewählt ist, laufen ihre Verbindungen über einen MDM-Proxy auf 127.0.0.1, der sie daran bindet (relay.rs); jedes Programm läuft in einem Ordner, in den es schreiben kann, auch sein TEMP (workdir.rs)
crates/crash mdm-crash Absturz- und Einfrierberichte: der Überwachungsprozess, Out-of-Process-Minidumps, symbolisierte Stacks, der Berichtstext und die Release-Logs (crash-reports.md)
crates/torrent mdm-torrent BitTorrent- und Magnet-Links über librqbit
crates/labserver mdm-labserver Ein HTTP-Range-Server mit einem Anforderungsprotokoll und Fehlerinjektion sowie ein FTP/FTPS-Server mit eigenen Fehlern für Tests und Benchmarks
extension/ — Die Chromium (MV3)- und Firefox-Erweiterung
docs/ — Die Bedienungsanleitung und Tutorials, diese Datei, die Benchmark-Daten; die Website macht die Anleitung zu ihren Hilfeseiten, die Hilfe öffnet
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

Abhängigkeiten zeigen nach innen: app, cli, mcp, nmhost und remote verwenden engine und ipc; die Engine weiß nichts von der UI. Die App sieht die Engine nur durch ihre Ereignisse (Fortschritt, Schnappschüsse der Segmenttabelle, abgeschlossen, fehlgeschlagen).

Engine

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

Wenn alle Segmente abgeschlossen sind, wird die Part-Datei mit der erwarteten Größe abgeglichen und umbenannt; das Dateidatum kann dem des Servers folgen.

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 und FTPS (ftp.rs) durchlaufen denselben Planer, dieselben Worker und denselben Zustand: Ein Segment ist REST + RETR auf einer Kontrollsitzung anstelle eines Bereichs- GET, SIZE und MDTM stehen für die Header, und Sitzungen werden pro Download gepoolt und zwischen Segmenten wiederverwendet.

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.

Designs

Jede Farbe und Größe, mit der ein Steuerelement gezeichnet wird, stammt vom aktiven Design (#45). Ein Design ist eine helle und eine dunkle Palette, Metriken, Steuerelementstile und ein Icon-Stil (palette.rs):

  • Palettenrollen. palette.rs deklariert jede Rolle mit einem stabilen Schlüssel ("button.hot", "list.row", "caption"…), einer Beschreibung und den hellen und dunklen Werten des klassischen Aussehens, ausgeschrieben (das klassische Aussehen wird nicht abgeleitet). Die gemeinsamen Painter (winui.rs, chrome.rs, list.rs, scrollbar.rs) lesen sie über theme::colors() und theme::metrics() und entscheiden daraus die Zustände jedes Steuerelements; kein Zeichencode hält eine eigene Farbe.
  • Abgeleitete Paletten. derive.rs erstellt eine ganze Palette aus wenigen Ausgangsfarben (Hintergrund, Oberfläche, Text, Akzent…), mischt jede andere Rolle in OKLab und hält den WCAG-Kontrast (4,5:1 für Text, 3:1 für Kanten) ein; Hoher Kontrast verstärkt jede Kante zusätzlich. native.rs leitet das System-Design aus dem Akzent und Kontrast des Systems ab (Windows-Einstellungen, das freedesktop-Portal unter Linux, macOS-Akzent).
  • Steuerelementstile. palette::Controls benennt die Form jedes Steuerelements (Textfelder, Kontrollkästchen, Schaltflächen, Fortschrittsbalken, Bildlaufleisten, die Fokusmarkierung, die Titelleiste); die Stilthemen (Metro, Adwaita, Breeze, Luna, Aero, Aqua, Emerald) wählen ihre eigenen, und unter Windows zeichnet MDM dann die Titelleiste selbst (die caption.*-Rollen).
  • Design-Dateien. themefile.rs liest TOML oder JSON aus dem themes-Ordner (eine Datei oder <id>/theme.toml mit Icons daneben). Eine Datei benennt nur, was sie ändert; der Rest stammt vom Design, das sie inherits (die ID eines integrierten Designs oder eine andere Datei, standardmäßig das klassische Aussehen), entlang einer Kette, in der ein Zyklus abgelehnt wird. Unbekannte Schlüssel sind Warnungen, keine Fehler. Die integrierten Stil-Designs sind ebenfalls solche Dateien, die im Programm enthalten sind (crates/app/assets/themes).
  • Icon-Sets. themeicons.rs zeichnet die Icons eines Designs (benannt nach ihrem Zweck: tb-add-url, cat-music…, SVG oder PNG in 16, 24, 32 und 48 px, -symbolic-Icons in der Textfarbe eingefärbt), wo das klassische Aussehen seine eigenen zeichnet; ein Bedarf, den das Set nicht deckt, behält das klassische Icon bei.

Wo ein Fenster seine Steuerelemente platziert, bleibt sein Layout. Das gilt auch für die Icons vor Dateinamen (fileicons.rs): die System-Imagelisten der Windows-Shell, macOS Finders (NSWorkspace), das Icon-Design des Linux-Desktops (xdgicons.rs, shared-mime-info und die Icon Theme Specification). Jeder Typ wird einmal pro Pixelgröße in einem Hintergrund-Thread nachgeschlagen. Tangos Icons (gebündelt) dienen als Platzhalter, bis das System-Icon bereit ist, und überall dort, wo das System keines hat.

Zeichnen

Die Fenster werden mit OpenGL (eframe's glow) oder mit der systemeigenen Grafik-API über eframe's wgpu gezeichnet, und zwar nur mit einem Backend: Direct3D 12 unter Windows (dort die Standardeinstellung), Vulkan unter Linux, Metal unter macOS (dort gibt es Auswahlmöglichkeiten; OpenGL bleibt die Standardeinstellung, bis echte Grafikkarten sie ausprobiert haben, #206). Ansicht → Zeichnen mit wählt eines davon für den nächsten Start aus. Ein einziger Codepfad macht dies auf jedem System (crates/app/src/renderer.rs): Wenn das gewählte Backend nicht starten kann, wird das andere versucht, sodass die Fenster immer geöffnet werden. Ein überwachter Start mit der System-API hinterlässt eine Markierung, bis der erste Frame gezeichnet ist: Ein Start, der vorher endet (ein Absturz im Treiber), einer, dessen erster Frame nicht innerhalb von 10 Sekunden erscheint (MDM startet dann erneut mit OpenGL), oder eine Grafikkarte, die zweimal in 10 Minuten verloren geht, wird mit ihrem Grund vermerkt, den das Menü anzeigt.

Ansicht → Oberflächengröße (scale.rs, #262) ist der Zoomfaktor von egui über die eigene Skalierung des Displays: Jedes Fenster wird in Punkten angelegt, sodass es entsprechend größer geöffnet wird; ein Fenster, das größer als der Bildschirm ist, scrollt.

Daten

Die Download-Liste und die Einstellungen werden atomar im Datenordner gespeichert (downloads.json): %APPDATA%\mattdownloadmanager\ unter Windows, ~/.local/share/mattdownloadmanager unter Linux, ~/Library/Application Support/mattdownloadmanager unter macOS, ein data-Ordner neben einer portablen Kopie oder MDM_DATA_DIR (mdm_ipc::data_dir). Der Browser-Host liest dieselbe Datei für die Erfassungsregeln, sodass eine Änderung in den Optionen für den nächsten erfassten Download gilt.

Anmeldegeheimnisse (Debrid-Konten, Anmeldedaten für Websites und Proxy-Passwörter) werden im System-Schlüsselbund gespeichert (secrets.rs, #44): Windows Credential Manager (win32.rs), der Secret Service unter Linux oder der macOS-Schlüsselbund (unix.rs). Die Einstellungen behalten eine keychain:<service>/<scope>/<key>-Referenz an ihrem Platz, die erst geschrieben wird, wenn der Schlüsselbund das Geheimnis bestätigt hat; ohne Schlüsselbund (oder mit einem gesperrten, der nie für MDM entsperrt wurde) bleibt das Geheimnis wie zuvor in den Einstellungen.

Der Serverstandort eines Downloads (#140) ist das Land der Adresse, mit der er verbunden war, nachgeschlagen in der Tabelle von mdm-geo auf diesem Computer (countries.rs benennt es in der Oberflächensprache); der Release-Job erstellt die Tabelle jeden Monat neu aus den Daten (tools/geo/build.py --release).

Browser-Integration

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

Die Erweiterung fragt den Host, welche Dateitypen übernommen werden sollen, prüft jeden Download dagegen und bricht den Browser-Download erst ab, nachdem die App ihn akzeptiert hat; andernfalls behält der Browser ihn, und die Erweiterung erklärt, warum.

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.

Der Host bedient nur MDMs eigene Erweiterung. Ihre IDs befinden sich an einem Ort, mdm_ipc::extension (crates/ipc/src/extension.rs): die der entpackten Kopie (UNPACKED_ID, vom öffentlichen Schlüssel des Manifests), die des Chrome Web Store (STORE_ID, signiert mit dem eigenen Schlüssel des Stores: pack.ps1 lässt den Manifestschlüssel aus der Store-Kopie weg), die des Firefox-Add-ons (FIREFOX_ID) und dessen addons.mozilla.org-Seite; die der Edge- und Opera-Stores sind Platzhalter, die nie bedient werden, bis die Erweiterung dort gelistet ist. Der Host schreibt das Manifest jedes Browsers mit diesen IDs, und die App bietet die Store-Kopie (Zu Chrome hinzufügen, Zu Firefox hinzufügen) vor der entpackten an.

Fernzugriff

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

--headless(headless.rs, #157) führt dasselbe App ohne eframe aus: Eine Schleife ruft dessen tick (was logic bei jedem Frame ausführt) auf einem nackten egui::Context auf, geweckt durch den Befehlskanal, und niemals dessen ui; Befehle werden hinzugefügt, wenn die Fernbedienung sie hinzufügt (kein Fenster). Die Dockerfile und docker/ (Compose, Unraid-Vorlage) führen es auf einem Server aus (server.md).

Der Server läuft auf der Tokio-Laufzeitumgebung der App, ein Listener pro lokaler Netzwerkadresse. Jede Anfrage wird geprüft (Host, Origin, Token), in ein mdm_ipc::Command umgewandelt, das als remote gekennzeichnet ist (ein Feld, das keine Anforderungszeile setzen kann), und über denselben Kanal wie die Befehlszeile an die App übergeben; die App beantwortet sie in ihrem nächsten Frame, so wie sie die Automatisierungs-API beantwortet. Ihre Seite ist eingebaut (crates/remote/web) und ihre Texte stammen aus den Katalogen der App (remote.rs).

Übersetzungen

Jeder Text, den die Benutzeroberfläche anzeigt, durchläuft crate::i18n (craft-i18n-Kataloge, i18n/<locale>.tsv). tools/i18n/extract.py erstellt i18n/en.tsv aus der Quelle neu, mit einem Hinweis für Übersetzer zu jedem Text (was er ist, wo er angezeigt wird, seine Platzhalter). tools/i18n/translate.py füllt, was den anderen Katalogen fehlt (Zeilen, die mit #, machine markiert sind), gemäß dem Stilhandbuch jeder Sprache (i18n/style/) und dem Glossar; eine von einer Person überprüfte Zeile wird niemals ersetzt, und CI (reviewed_guard.py) lässt eine Änderung fehlschlagen, die eine solche Zeile löscht. Die Website hat ihre eigenen Kataloge (i18n/site/, tools/website/translate_site.py).

Bilder

Die Bilder der Hilfeseiten (docs/images/help/) stammen aus einer Liste, tools/shots/shots.toml: tools/shots/make.py öffnet jedes Fenster über MDMs eigenen /show <window>-Befehlszeilenbefehl in einer Testinstanz außerhalb des Bildschirms, schneidet es zu und kommentiert es aus dem Barrierefreiheitsbaum des Fensters und schreibt verlustfreies WebP; make.py check (CI) hält die Liste, die Seiten und die Dateien synchron. Die veröffentlichten Bilder werden auf GitHubs Windows-Runner (docs-shots.yml) erstellt.

Mitwirkende

tools/contributors.pyliest von GitHubs öffentlicher API, wer Pull Requests und Issues geöffnet und wer kommentiert hat (der Maintainer, Claude und Bots ausgenommen), für jeden Ort, der ihnen dankt: die Startseite der Website, /contributors.html und jede Veröffentlichung auf der News-Seite (build.py, bei jedem Build), die Versionshinweise jeder Veröffentlichung (release.yml, die seit der vorherigen Veröffentlichung aktiven Personen) und die README (python tools/contributors.py readme bei der Vorbereitung jeder Veröffentlichung: ihre runden Fotos werden in art/contributors/ committet, da GitHub ein Bild in einer README nicht runden kann).

Tests und Benchmarks

cargo testführt Unit-Tests und End-to-End-Downloads gegen mdm-labserver mit injizierten Fehlern (langsame, abgebrochene und abgelehnte Verbindungen, Server ohne Bereiche, sich ändernde Dateien) aus. tools/bench führt den veröffentlichten Geschwindigkeitsvergleich aus; seine Rohdaten befinden sich in docs/bench/.

Kostenlos, Open Source, keine Werbung, keine Testversion.

Matt Download Manager herunterladen