Dannex Download Manager
  1. Home
  2. Help
  3. Architectuur

Architectuur

Hoe de onderdelen van Dannex Download Manager samenwerken.

Crates

Pad Crate Rol
crates/engine mdm-engine Downloadt één bestand via HTTP(S) of FTP(S): probe, segmentplanner, verbindingswerkers, hervattingsstatus, limieten per host, snelheidsbegrenzer, checksums, proxyscripts
crates/app mdm-app De desktop-app (dannexdownloadmanager.exe, egui): lijst, categorieën, wachtrijen, planner, dialoogvensters, systeemvak, instellingen
crates/cli mdm-cli Downloads zonder grafische interface met voortgang (get, resume), video's, torrents en opdrachten van de automatiserings-API: een bibliotheek die het programma van de app uitvoert (dannexdownloadmanager --cli …), en dannexdownloadmanager-cli, een kleine starter die de bibliotheek start met dezelfde argumenten, terminal en afsluitcode
crates/mcp mdm-mcp De MCP-server (dannexdownloadmanager-mcp): AI-assistenten kunnen via de automatiserings-API de downloads in de actieve app weergeven, toevoegen en beheren
crates/remote mdm-remote De afstandsbediening (#141): de HTTPS-server die een gekoppelde telefoon of computer op het lokale netwerk gebruikt (de pagina, koppelingscodes, apparaattokens, het zelfondertekende certificaat); elk verzoek wordt een automatiserings-API-opdracht die de app beantwoordt
crates/nmhost mdm-nmhost De native messaging-host van de browser: ontvangt vastgelegde downloads van de extensie en geeft ze door aan de app
crates/ipc mdm-ipc Het kanaal voor één instantie (een met een token beveiligde lokale socket), de gegevensmap en de vastlegregels die de app en de host delen
crates/debrid mdm-debrid Debrid-accounts (#44): de officiële API's van de diensten (Real-Debrid, AllDebrid, Premiumize, TorBox) zetten een link van een bestandshost om in een directe link die de engine downloadt
crates/extract mdm-extract Archiefuitpakking (#37): zip, tar, gz en xz in uitvoering; 7z en RAR via een geïnstalleerde 7-Zip, uitgevoerd als een eigen programma
crates/geo mdm-geo Waar de server van een download zich bevindt (#140): een IP-naar-land-bereiktabel, opgebouwd uit DB-IP's Lite-gegevens (tools/geo/build.py), alleen op deze computer opgezocht, en de vlaggen van de landen
crates/tools mdm-tools Videopagina's via yt-dlp en ffmpeg, fotogalerijen via gallery-dl (uitgevoerd als aparte programma's); als een netwerkadapter is gekozen, lopen hun verbindingen via een proxy van DDM op 127.0.0.1 die ze eraan bindt (relay.rs)
crates/crash mdm-crash Crash- en vastlooprapporten: het monitorproces, minidumps buiten het proces, van symbolen voorziene stacktraces, de rapporttekst en de releaselogboeken (crash-reports.md)
crates/torrent mdm-torrent BitTorrent en magneetlinks via librqbit
crates/labserver mdm-labserver Een HTTP Range-server met een verzoeklogboek en foutinjectie, en een FTP/FTPS-server met eigen fouten, voor tests en benchmarks
extension/ — De extensie voor Chromium (MV3) en Firefox
docs/ — De gebruikershandleiding en zelfstudies, dit bestand en de benchmarkgegevens; de website gebruikt de handleiding als helppagina's die u opent via Help
website/ — De eigen pagina's van dannex.kavangi.co.ke (home, download, features, themes, FAQ); tools/website/build.py voegt de help van docs/ en het nieuws van de CHANGELOG toe, in 22 talen, en GitHub Pages publiceert het

Afhankelijkheden wijzen naar binnen: app, cli, mcp, nmhost en remote gebruiken engine en ipc; de engine weet niets van de UI. De app ziet de engine alleen via de gebeurtenissen (voortgang, momentopnamen van de segmenttabel, voltooid, mislukt).

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

Wanneer alle segmenten zijn voltooid, wordt het deelbestand gecontroleerd op de verwachte grootte en op de juiste plek hernoemd; de datum van het bestand kan die van de server overnemen.

Het eerste verzoek van een download (get) volgt omleidingen en pagina's die vanzelf naar een bestand leiden (zoals het vernieuwen van een wachtpagina). Voor sites waarvan de links niet rechtstreeks naar het bestand verwijzen, is er een module in sites/ (Google Drive: sites/gdrive.rs). Deze zet de link om in het adres van het bestand, leest de eigen pagina's van de site (zoals een bevestigingsformulier of een foutpagina) en geeft aan waarom een verzoek is geweigerd (Error::Refused). De pure functies worden zonder netwerk getest. Voor de end-to-endtests laat de labserver zo'n site draaien op de echte hostnamen (labserver/src/drive.rs).

FTP en FTPS (ftp.rs) gebruiken dezelfde planner, werkers en status: een segment bestaat uit REST + RETR op een controlesessie in plaats van een GET met een bereik. SIZE en MDTM vervangen de headers, en sessies worden per download gepoold en tussen segmenten hergebruikt.

App

Eén egui-venster getekend op vaste pixelcoördinaten, plus één directe viewport per dialoogvenster. app.rs beheert de status (downloads, wachtrijen, instellingen, de selectie van de lijst) en zet menu-, werkbalk-, toets- en IPC-opdrachten om in acties. Elk dialoogvenster is een eigen module en retourneert een Outcome (open, gesloten, voltooid met een waarde). Windows-specifieke aanroepen zijn beperkt tot win32.rs en hun Linux- en macOS-tegenhangers tot unix.rs (beginnend met de sessie, de browserhost, geluiden, tonen in map, de crashhandler); elk ander bestand is veilige, draagbare Rust. Lettertypen komen van het systeem: de map Fonts van Windows, de systeemlettertypen van macOS, fontconfig op Linux (theme.rs). Op Windows wordt Latijnse, Griekse en Cyrillische tekst getekend door DirectWrite (win32.rs, via de glyph-rasterizer-hook van egui): Beeld → Tekst → Vloeiend in de natuurlijke modus, anti-aliased op de gevraagde grootte en geplaatst op kwartpixels met de eigen spatiëring van het lettertype; Klassiek (de standaard) in GDI-klassieke modus, zodat de gehintte vorm en de hele-pixelbreedte van elke letter samenkomen. Andere scripts worden gevormd en getekend door egui.

Thema's

Elke kleur en grootte waarmee een besturingselement wordt getekend, komt van het actieve thema (#45). Een thema is een licht en een donker palet, metrische gegevens, besturingsstijlen en een pictogramstijl (palette.rs):

  • Paletrollen. palette.rs declareert elke rol met een stabiele sleutel ("button.hot", "list.row", "caption"…), een beschrijving en de lichte en donkere waarden van de klassieke look, uitgeschreven (de klassieke look is niet afgeleid). De gedeelde tekenaars (winui.rs, chrome.rs, list.rs, scrollbar.rs) lezen deze via theme::colors() en theme::metrics() en bepalen hieruit de statussen van elk besturingselement; geen enkele tekeningcode heeft een eigen kleur.
  • Afgeleide paletten. derive.rs maakt een heel palet uit een paar basiskleuren (achtergrond, oppervlak, tekst, accent…), waarbij elke andere rol in OKLab wordt gemengd en het WCAG-contrast behouden blijft (4,5:1 voor tekst, 3:1 voor randen); Hoog contrast versterkt elke rand daarbovenop. native.rs zaait het Systeemeigen thema uit het accent en contrast van het systeem (Windows-instellingen, het freedesktop-portaal op Linux, macOS-accent).
  • Besturingselementstijlen. palette::Controls benoemt de vorm van elk besturingselement (tekstvakken, selectievakjes, knoppen, voortgangsbalken, schuifbalken, de focusmarkering, de titelbalk); de stijlthema's (Metro, Adwaita, Breeze, Luna, Aero, Aqua, Emerald) kiezen hun eigen stijl, en op Windows tekent DDM dan zelf de titelbalk (de caption.*-rollen).
  • Themabestanden. themefile.rs leest TOML of JSON uit de themes van de gegevensmap (één bestand, of <id>/theme.toml met pictogrammen ernaast). Een bestand benoemt alleen wat het wijzigt; de rest komt van het thema dat het inherits (de id van een ingebouwd thema of een ander bestand, standaard de klassieke look), via een keten waarin een cyclus wordt geweigerd. Onbekende sleutels zijn waarschuwingen, geen fouten. De ingebouwde themastijlen zijn ook zulke bestanden, meegenomen in het programma (crates/app/assets/themes).
  • Pictogramsets. themeicons.rs tekent de pictogrammen van een thema (benoemd naar waarvoor ze dienen: tb-add-url, cat-music…, SVG of PNG op 16, 24, 32 en 48 px, -symbolic exemplaren in de tekstkleur) waar de klassieke look zijn eigen pictogrammen tekent; een behoefte die de set mist, behoudt het klassieke pictogram.
  • Pictogramstijlen van de werkbalk. Beeld → Werkbalk → Lijnstijl (de omtrekken, ingekleurd zoals het thema bepaalt) of 3D-stijl: de eigen glanzende afbeeldingen van DDM (assets/icons/toolbar3d, getekend door tools/icon/toolbar_3d.py op 16 tot 64 px, de afbeelding die bij de grootte op het scherm hoort; grijs gemaakt door icons.rs wanneer uitgeschakeld). Ze gelden waar het thema geen eigen pictogram voor een knop heeft en pictogrammen in hun eigen kleuren inkleurt; een thema met een eigen pictogramset, of een thema dat pictogrammen in één kleur inkleurt (Hoog contrast), behoudt zijn eigen pictogrammen.

Waar een venster zijn besturingselementen plaatst, blijft de lay-out. Dat geldt ook voor de pictogrammen vóór bestandsnamen (fileicons.rs): de systeemafbeeldingslijsten van de Windows-shell, die van macOS Finder (NSWorkspace), het pictogramthema van de Linux-desktop (xdgicons.rs, shared-mime-info en de Icon Theme Specification). Elk type wordt één keer per pixelgrootte opgezocht, op een achtergrondthread. Tango's pictogrammen (meegeleverd) dienen als tijdelijke aanduiding totdat het systeempictogram gereed is, en overal waar het systeem er geen heeft.

Tekenen

De vensters worden getekend met OpenGL (eframe's glow) of met de eigen grafische API van het systeem via eframe's wgpu, met alleen die ene backend: Direct3D 12 op Windows (de standaard daar), Vulkan op Linux, Metal op macOS (keuzes daar; OpenGL blijft hun standaard totdat echte grafische kaarten ze hebben geprobeerd, #206). Beeld → Tekenen met kiest er één, vanaf de volgende start. Eén codepad doet het op elk systeem (crates/app/src/renderer.rs): wanneer de gekozen niet kan starten, wordt de andere geprobeerd, zodat de vensters altijd openen. Een bewaakte start met de systeem-API laat een markering achter totdat het eerste frame is getekend: een start die eindigt voordat het zover is (een crash in de driver), een waarvan het eerste frame niet binnen 10 seconden verschijnt (DDM start dan opnieuw met OpenGL), of een grafische kaart die twee keer in 10 minuten verloren is gegaan, wordt onthouden met de reden, die het menu toont.

Beeld → Interfasegrootte (scale.rs, #262) is de zoomfactor van egui over de eigen schaal van het scherm: elk venster wordt in punten ingedeeld, dus het opent zoveel groter; een groter dan het scherm scrollt.

Gegevens

De downloadlijst en instellingen worden atomair opgeslagen in de gegevensmap (downloads.json): %APPDATA%\dannexdownloadmanager\ op Windows, ~/.local/share/dannexdownloadmanager op Linux, ~/Library/Application Support/dannexdownloadmanager op macOS, een data map naast een draagbare kopie, of MDM_DATA_DIR (mdm_ipc::data_dir). De browserhost leest hetzelfde bestand voor de vastlegregels, dus een wijziging in Opties is van toepassing op de volgende vastgelegde download.

Aanmeldingsgeheimen (debrid-accounts, Siteaanmeldingen en de wachtwoorden van de proxy) bevinden zich in de sleutelhanger van het systeem (secrets.rs, #44): Windows Credential Manager (win32.rs), de Secret Service op Linux of de macOS-sleutelhanger (unix.rs). De instellingen bewaren een keychain:<service>/<scope>/<key> referentie op hun plaats, die pas wordt geschreven nadat de sleutelhanger het geheim heeft bevestigd; zonder sleutelhanger (of met een vergrendelde, nooit ontgrendeld voor DDM) blijft het geheim zoals voorheen in de instellingen staan.

De serverlocatie van een download (#140) is het land van het adres waarmee het verbinding maakte, opgezocht in de tabel van mdm-geo op deze computer (countries.rs benoemt het in de interfacetaal); de release-taak bouwt de tabel opnieuw op uit de gegevens van de maand (tools/geo/build.py --release).

Browserintegratie

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

De extensie vraagt de host welke bestandstypen moeten worden overgenomen, controleert elke download hierop en annuleert de download van de browser pas nadat de app deze heeft geaccepteerd; anders behoudt de browser deze, en de extensie legt uit waarom.

Hetzelfde antwoord bevat de toetsen van Opties → Algemeen (keys: waarmee page.js een klik herkent, om een koppeling aan de browser over te laten of af te dwingen voor de app) en de weer te geven rechtsklikitems (menu: background.js maakt zijn menu opnieuw wanneer ze veranderen); het antwoord op de vraag of de videoknop mag worden getoond bevat de instellingen van Downloadvensters (panel: boven video's of audiospelers, de minimale lengte, de eerste hoek). Hun namen en standaardwaarden zijn die van mdm_ipc::capture, gelezen uit de instellingen die de app opslaat. De extensie vraagt opnieuw wanneer het venster van de browser de focus terugkrijgt (enkele seconden nadat ze voor het laatst vroeg), wanneer een pagina start (15 s) en bij een download (een minuut).

De lijst met downloads in de popup van de werkbalk (Pauzeren, Hervatten, Map openen) en het getal op de knop zijn de list en acties van de automatiserings-API, opgevraagd via de host met browser ingesteld: de app beantwoordt die ongeacht de schakelaar van de API, zoals ze ook het kwaliteitsmenu van de videoknop beantwoordt, en de host start de app er nooit voor. De extensie vraagt alleen terwijl de popup open is of downloads actief zijn.

De host bedient alleen DDM's eigen extensie. De ID's bevinden zich op één plaats, mdm_ipc::extension (crates/ipc/src/extension.rs): die van de uitgepakte kopie (UNPACKED_ID, van de openbare sleutel van het manifest), die van de Chrome Web Store (STORE_ID, ondertekend met de eigen sleutel van de store: pack.ps1 laat de sleutel van het manifest weg uit de kopie van de store), die van de Firefox-add-on (FIREFOX_ID) en de pagina addons.mozilla.org; die van de Edge- en Opera-stores zijn tijdelijke aanduidingen, nooit aangeboden, totdat de extensie daar wordt vermeld. De host schrijft het manifest van elke browser met die ID's, en de app biedt de kopie van de store aan (Toevoegen aan Chrome, Toevoegen aan Firefox) vóór de uitgepakte.

Afstandsbediening

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

--headless(headless.rs, #157) draait dezelfde App zonder eframe: een lus roept de tick aan (wat logic bij elk frame uitvoert) op een kale egui::Context, gewekt door het commandokanaal, en nooit de ui; commando's worden toegevoegd zoals de afstandsbediening ze toevoegt (geen venster). De Dockerfile en docker/ (Compose, Unraid's template) draaien het op een server (server.md).

De server draait op de Tokio-runtime van de app, één listener per lokaal netwerkadres. Elk verzoek wordt gecontroleerd (Host, Origin, token), omgezet in een mdm_ipc::Command gemarkeerd remote (een veld dat geen enkele verzoekregel kan instellen) en via hetzelfde kanaal als de opdrachtregel aan de app doorgegeven; de app beantwoordt het in het volgende frame, net zoals het de automatiserings-API beantwoordt. De pagina wordt ingebouwd (crates/remote/web) en de teksten komen uit de catalogi van de app (remote.rs).

Vertalingen

Elke tekst die de UI toont, gaat via crate::i18n (craft-i18n-catalogi, i18n/<locale>.tsv). tools/i18n/extract.py herbouwt i18n/en.tsv vanuit de bron, met een notitie voor vertalers bij elke tekst (wat het is, waar het wordt getoond, de placeholders). tools/i18n/translate.py vult aan wat de andere catalogi missen (rijen gemarkeerd met #, machine), volgens de stijlgids van elke taal (i18n/style/) en de woordenlijst; een rij die door een persoon is beoordeeld, wordt nooit vervangen, en CI (reviewed_guard.py) mislukt bij een wijziging die er een verwijdert. De website heeft zijn eigen catalogi (i18n/site/, tools/website/translate_site.py).

Afbeeldingen

Het app-pictogram wordt getekend uit geometrie (tools/icon/dannex_logo.py; build_icon.py schrijft elke grootte, met de hand op hele pixels geplaatst van 16 tot 48 px). Elke plek die het toont, gebruikt de tekening voor zijn grootte op het scherm (logo.rs): in Windows de pictogrammen in de titelbalk en op de taakbalk van elk venster op de schaal van zijn beeldscherm (win32::crisp_icons, die ze ook behoudt bij een verplaatsing naar een ander beeldscherm), dat van het systeemvak op de schaal van de taakbalk. Beeld → DDM Systeemvakpictogram toont het in volle kleur (3D-stijl) of alleen het merkteken in de kleur van de taakbalk (Platte stijl: wit op een donkere taakbalk, donker op een lichte; een sjabloonafbeelding op macOS), met een smalle balk onderaan terwijl downloads actief zijn.

De afbeeldingen van de helppagina's (docs/images/help/) komen uit één lijst, tools/shots/shots.toml: tools/shots/make.py opent elk venster via DDM's eigen /show <window> commandoregel in een testinstantie buiten het scherm, snijdt het bij en annoteert het vanuit de toegankelijkheidsboom van het venster, en schrijft lossless WebP; make.py check (CI) houdt de lijst, de pagina's en de bestanden synchroon. De gepubliceerde afbeeldingen worden gemaakt op de Windows-runner van GitHub (docs-shots.yml).

Medewerkers

tools/contributors.pyleest wie pull requests en issues heeft geopend en wie commentaar heeft gegeven, via de openbare API van GitHub (de beheerder, Claude en bots zijn weggelaten) voor elke plek waar ze worden bedankt: de startpagina van de website, /contributors.html en elke release op de Nieuwspagina (build.py, bij elke build), de notities van elke release (release.yml, de mensen die actief waren sinds de vorige release) en de README (python tools/contributors.py readme bij de voorbereiding van elke release: de ronde foto's worden vastgelegd in art/contributors/, aangezien GitHub geen ronde afbeelding kan maken in een README).

Tests en benchmarks

cargo testvoert unit-tests en end-to-end downloads uit tegen mdm-labserver met geïnjecteerde fouten (trage, verbroken en geweigerde verbindingen, servers zonder bereiken, veranderende bestanden). tools/bench voert de gepubliceerde snelheidsvergelijking uit; de ruwe data staat in docs/bench/.

De frames van de vensters worden gemeten, niet geschat (crates/app/src/framestats.rs): MDM_FRAME_STATS=1 logt elke seconde de tekenrondes van het hoofdvenster, hoeveel er door invoer kwamen, wat ze kosten (het hoofdvenster, de voortgangsvensters, hun indeling) en welke regels code om de overige vroegen; MDM_SYNTHETIC_LIST=10000 (met een tijdelijke MDM_DATA_DIR) voegt zoveel verzonnen rijen toe; MDM_BENCH_SCROLL=10 scrolt de lijst tien seconden lang zelf en logt de frametijden. Een rustend venster heeft alleen de frames van zijn klok (één per 2 s); de lijst tekent alleen de zichtbare rijen.

Gratis, open source, geen advertenties, geen proefversie.

Dannex Download Manager downloaden