Dannex Download Manager
  1. Accueil
  2. Aide
  3. Architecture

Architecture

Comment les composants de Dannex Download Manager s'assemblent.

Bibliothèques

Chemin Bibliothèque Rôle
crates/engine mdm-engine Télécharge un fichier via HTTP(S) ou FTP(S) : sonde, planificateur de segments, travailleurs de connexion, état de reprise, limites par hôte, limiteur de vitesse, sommes de contrôle, scripts proxy
crates/app mdm-app L'application de bureau (dannexdownloadmanager.exe, egui) : liste, catégories, files d'attente, planificateur, dialogues, barre d'état système, paramètres
crates/cli mdm-cli Téléchargements sans interface avec progression (get, resume), vidéos, torrents et commandes de l'API d'automatisation : une bibliothèque exécutée par le programme de l'application (dannexdownloadmanager --cli …), et dannexdownloadmanager-cli, un petit lanceur qui la démarre avec les mêmes arguments, terminal et code de sortie
crates/mcp mdm-mcp Le serveur MCP (dannexdownloadmanager-mcp) : les assistants IA listent, ajoutent et contrôlent les téléchargements de l'application en cours via l'API d'automatisation
crates/remote mdm-remote Le contrôle à distance (#141) : le serveur HTTPS qu'un téléphone ou un ordinateur appairé sur le réseau local utilise (sa page, les codes d'appairage, les jetons d'appareil, le certificat auto-signé) ; chaque requête devient une commande de l'API d'automatisation à laquelle l'application répond
crates/nmhost mdm-nmhost L'hôte de messagerie native du navigateur : prend les téléchargements capturés de l'extension et les transmet à l'application
crates/ipc mdm-ipc Le canal à instance unique (un socket local protégé par un jeton), le dossier de données et les règles de capture partagées par l'application et l'hôte
crates/debrid mdm-debrid Comptes de débridage (#44) : les API officielles des services (Real-Debrid, AllDebrid, Premiumize, TorBox) transforment le lien d’un hébergeur de fichiers en un lien direct que le moteur télécharge.
crates/extract mdm-extract Extraction d’archives (#37) : zip, tar, gz et xz en cours ; 7z et RAR via 7-Zip installé, exécuté comme un programme distinct.
crates/geo mdm-geo Emplacement du serveur d’un téléchargement (#140) : une table de correspondance IP-pays construite à partir des données Lite de DB-IP (tools/geo/build.py), consultée uniquement sur cet ordinateur, et les drapeaux des pays.
crates/tools mdm-tools Les pages vidéo via yt-dlp et ffmpeg, les galeries d'images via gallery-dl (exécutés comme des programmes distincts) ; lorsqu'une carte réseau est choisie, leurs connexions passent par un proxy de DDM sur 127.0.0.1 qui les y lie (relay.rs).
crates/crash mdm-crash Rapports de crash et de blocage : le processus de surveillance, les minidumps hors processus, les piles symbolisées, le texte du rapport et les journaux de publication (crash-reports.md)
crates/torrent mdm-torrent Liens BitTorrent et magnet via librqbit
crates/labserver mdm-labserver Un serveur HTTP Range avec un journal de requêtes et une injection de pannes, et un serveur FTP/FTPS avec ses propres pannes, pour les tests et les benchmarks
extension/ — L'extension Chromium (MV3) et Firefox
docs/ — Le guide de l'utilisateur et les tutoriels, ce fichier, les données de référence ; le site web fait du guide ses pages d'aide, que Aide ouvre
website/ — Les pages de dannex.kavangi.co.ke (accueil, téléchargement, fonctionnalités, thèmes, FAQ) ; tools/website/build.py ajoute l’aide de docs/ et les actualités du CHANGELOG, en 22 langues, et GitHub Pages les publie.

Les dépendances pointent vers l'intérieur : app, cli, mcp, nmhost et remote utilisent engine et ipc ; le moteur ne sait rien de l'interface utilisateur. L'application ne voit le moteur qu'à travers ses événements (progression, instantanés de la table des segments, terminé, échec).

Moteur

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

Lorsque tous les segments sont terminés, le fichier partiel est vérifié par rapport à la taille attendue et renommé à sa place ; la date du fichier peut suivre celle du serveur.

La première requête d'un téléchargement (get) suit les redirections et les pages qui mènent d'elles-mêmes à un fichier (l'actualisation d'une page d'attente). Les sites dont les liens ne sont pas l'adresse du fichier ont un module dans sites/ (Google Drive : sites/gdrive.rs) : il transforme le lien en adresse du fichier, lit les pages propres au site (un formulaire de confirmation, une page d'erreur) et nomme ses refus (Error::Refused), avec des fonctions pures testées sans réseau. Le serveur de laboratoire joue un tel site sur ses vrais noms d'hôte pour les tests de bout en bout (labserver/src/drive.rs).

FTP et FTPS (ftp.rs) passent par le même planificateur, les mêmes travailleurs et le même état : un segment est REST + RETR sur une session de contrôle au lieu d'un GET, SIZE et MDTM à plage remplacent les en-têtes, et les sessions sont regroupées par téléchargement et réutilisées entre les segments.

Application

Une fenêtre egui peinte à des coordonnées de pixels fixes, plus une fenêtre d’affichage immédiate par boîte de dialogue. app.rs contient l’état (téléchargements, files d’attente, paramètres, sélection de la liste) et transforme les commandes de menu, de barre d’outils, de clavier et IPC en actions. Chaque boîte de dialogue est son propre module et renvoie un Outcome (ouvert, fermé, terminé avec une valeur). Les appels spécifiques à Windows sont confinés à win32.rs et leurs équivalents Linux et macOS à unix.rs (démarrage de la session, hôte des navigateurs, sons, afficher dans le dossier, gestionnaire de plantage) ; tout autre fichier est du Rust sûr et portable. Les polices proviennent du système : dossier Polices de Windows, polices système de macOS, fontconfig sur Linux (theme.rs). Sur Windows, le texte latin, grec et cyrillique est dessiné par DirectWrite (win32.rs, via le hook de rastérisation de glyphes d’egui) : Affichage → Texte → Lissé dans son mode naturel, anticrénelé à la taille demandée et placé à des quarts de pixels avec les avancées propres à la police ; Classique (par défaut) en mode GDI-classique, de sorte que la forme hintée et la largeur en pixels entiers de chaque lettre s’assemblent. Les autres scripts sont mis en forme et dessinés par egui.

Thèmes

Chaque couleur et taille avec laquelle un contrôle est dessiné provient du thème actif (#45). Un thème est une palette claire et une sombre, des métriques, des styles de contrôle et un style d’icône (palette.rs) :

  • Rôles de la palette. palette.rs déclare chaque rôle avec une clé stable ("button.hot", "list.row", "caption"…), une description et les valeurs claires et sombres de l’apparence classique, écrites (l’apparence classique n’est pas dérivée). Les peintres partagés (winui.rs, chrome.rs, list.rs, scrollbar.rs) les lisent via theme::colors() et theme::metrics() et décident des états de chaque contrôle à partir de ceux-ci ; aucun code de peinture ne contient sa propre couleur.
  • Palettes dérivées. derive.rs crée une palette complète à partir de quelques graines (arrière-plan, surface, texte, accent…), mélangeant tous les autres rôles en OKLab et maintenant le contraste WCAG (4,5:1 pour le texte, 3:1 pour les bords) ; Contraste élevé renforce chaque bord. native.rs initialise le thème Natif à partir de l’accent et du contraste du système (paramètres de Windows, le portail freedesktop sur Linux, l’accent de macOS).
  • Styles des contrôles. palette::Controls nomme la forme de chaque contrôle (zones de texte, cases à cocher, boutons, barres de progression, barres de défilement, marque de focus, barre de titre) ; les thèmes de style (Metro, Adwaita, Breeze, Luna, Aero, Aqua, Emerald) choisissent les leurs, et sur Windows, DDM dessine ensuite lui-même la barre de titre (les rôles caption.*).
  • Fichiers de thème. themefile.rs lit TOML ou JSON depuis le dossier de données themes (un fichier, ou <id>/theme.toml avec des icônes à côté). Un fichier ne nomme que ce qu’il modifie ; le reste provient du thème qu’il inherits (l’ID d’un thème intégré ou un autre fichier, l’apparence classique par défaut), le long d’une chaîne dans laquelle un cycle est refusé. Les clés inconnues sont des avertissements, pas des erreurs. Les thèmes de style intégrés sont également de tels fichiers, inclus dans le programme (crates/app/assets/themes).
  • Jeux d’icônes. themeicons.rs dessine les icônes d’un thème (nommées par leur fonction : tb-add-url, cat-music…, SVG ou PNG à 16, 24, 32 et 48 px, -symbolic encrées dans la couleur du texte) là où l’apparence classique dessine les siennes ; un besoin que le jeu ne satisfait pas conserve l’icône classique.
  • Styles d’icônes de la barre d’outils. Affichage → Barre d’outils → Style linéaire (les contours, colorés comme l’indique le thème) ou Style 3D : les images brillantes propres à DDM (assets/icons/toolbar3d, dessinées par tools/icon/toolbar_3d.py de 16 à 64 px, celle qui convient à la taille affichée ; grisées par icons.rs quand le bouton est désactivé). Ils s’appliquent quand le thème n’a pas d’icône propre pour un bouton et affiche ses icônes dans leurs propres couleurs ; un thème avec un jeu d’icônes, ou qui teinte les icônes d’une seule couleur (Contraste élevé), garde les siennes.

L’emplacement des contrôles d’une fenêtre reste sa disposition. Il en va de même pour les icônes devant les noms de fichiers (fileicons.rs) : les listes d’images système du shell Windows, celles du Finder de macOS (NSWorkspace), le thème d’icônes du bureau Linux (xdgicons.rs, shared-mime-info et la spécification Icon Theme Specification). Chaque type est recherché une fois par taille de pixel, sur un thread d’arrière-plan. Les icônes de Tango (fournies) sont utilisées jusqu’à ce que l’icône du système soit prête, et partout où le système n’en a pas.

Dessin

Les fenêtres sont dessinées avec OpenGL (glow d’eframe) ou avec l’API graphique du système via wgpu d’eframe, avec ce seul backend : Direct3D 12 sur Windows (le défaut), Vulkan sur Linux, Metal sur macOS (choix possibles ; OpenGL reste leur défaut jusqu’à ce que de vraies cartes graphiques les aient essayés, #206). Affichage → Dessiner avec en choisit un, à partir du prochain démarrage. Un seul chemin de code le fait sur chaque système (crates/app/src/renderer.rs) : si celui choisi ne peut pas démarrer, l’autre est essayé, de sorte que les fenêtres s’ouvrent toujours. Un démarrage surveillé avec l’API du système laisse un marqueur jusqu’à ce que sa première image soit dessinée : un démarrage qui se termine avant (un crash dans le pilote), un dont la première image n’arrive pas dans les 10 secondes (DDM redémarre alors avec OpenGL), ou une carte graphique perdue deux fois en 10 minutes est mémorisé avec sa raison, que le menu affiche.

Affichage → Taille de l’interface (scale.rs, #262) est le facteur de zoom d’egui sur l’échelle propre de l’affichage : chaque fenêtre est agencée en points, elle s’ouvre donc d’autant plus grande ; une fenêtre plus grande que l’écran défile.

Données

La liste de téléchargements et les paramètres sont enregistrés de manière atomique dans le dossier de données (downloads.json) : %APPDATA%\dannexdownloadmanager\ sur Windows, ~/.local/share/dannexdownloadmanager sur Linux, ~/Library/Application Support/dannexdownloadmanager sur macOS, un dossier data à côté d’une copie portable, ou MDM_DATA_DIR (mdm_ipc::data_dir). L’hôte du navigateur lit le même fichier pour les règles de capture, de sorte qu’une modification dans Options s’applique au prochain téléchargement capturé.

Les secrets de connexion (comptes de débridage, mots de passe des Connexions aux sites et du proxy) résident dans le trousseau du système (secrets.rs, #44) : Gestionnaire d’informations d’identification Windows (win32.rs), le Secret Service sur Linux ou le trousseau macOS (unix.rs). Les paramètres conservent une référence keychain:<service>/<scope>/<key> à leur place, écrite seulement une fois que le trousseau a confirmé le secret ; sans trousseau (ou avec un trousseau verrouillé, jamais déverrouillé pour DDM), le secret reste dans les paramètres comme avant.

L’emplacement du serveur d’un téléchargement (#140) est le pays de l’adresse à laquelle il s’est connecté, recherché dans la table de mdm-geo sur cet ordinateur (countries.rs le nomme dans la langue de l’interface) ; la tâche de publication reconstruit la table à partir des données du mois (tools/geo/build.py --release).

Intégration au navigateur

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

L’extension demande à l’hôte quels types de fichiers prendre en charge, vérifie chaque téléchargement par rapport à ceux-ci, et n’annule le téléchargement du navigateur qu’après que l’application l’a accepté ; sinon, le navigateur le conserve, et l’extension indique pourquoi.

La même réponse contient les touches de Options → Général (keys : celles avec lesquelles page.js retient un clic, pour laisser un lien au navigateur ou le forcer vers l’application) et les éléments du menu contextuel à afficher (menu : background.js recrée son menu quand ils changent) ; la réponse indiquant si le bouton vidéo peut s’afficher contient les paramètres de Panneaux de téléchargement (panel : sur les vidéos ou les lecteurs audio, la durée minimale, le premier coin). Leurs noms et leurs valeurs par défaut sont ceux de mdm_ipc::capture, lus dans les paramètres enregistrés par l’application. L’extension interroge de nouveau l’application quand la fenêtre du navigateur reprend le focus (quelques secondes après la dernière demande), au chargement d’une page (15 s) et lors d’un téléchargement (une minute).

La liste des téléchargements de la fenêtre contextuelle de la barre d’outils (Suspendre, Reprendre, Ouvrir le dossier) et le nombre affiché sur le bouton relèvent de list et des actions de l’API d’automatisation, demandés via l’hôte avec browser défini : l’application y répond quel que soit l’interrupteur de l’API, comme elle répond au menu de qualité du bouton vidéo, et l’hôte ne lance jamais l’application pour cela. L’extension ne pose ces questions que tant que la fenêtre est ouverte ou que des téléchargements sont en cours.

L’hôte ne sert que l’extension propre à DDM. Ses ID sont à un seul endroit, mdm_ipc::extension (crates/ipc/src/extension.rs) : celui de la copie décompressée (UNPACKED_ID, à partir de la clé publique du manifeste), celui du Chrome Web Store (STORE_ID, signé avec la propre clé du magasin : pack.ps1 exclut la clé du manifeste de la copie du magasin), celui de l’extension Firefox (FIREFOX_ID) et sa page addons.mozilla.org ; ceux des magasins Edge et Opera sont des espaces réservés, jamais servis, tant que l’extension n’y est pas listée. L’hôte écrit le manifeste de chaque navigateur avec ces ID, et l’application propose la copie du magasin (Ajouter à Chrome, Ajouter à Firefox) avant la copie décompressée.

Contrôle à distance

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

--headless(headless.rs, #157) exécute le même App sans eframe : une boucle appelle son tick (ce que logic exécute à chaque image) sur un egui::Context nu, réveillé par le canal de commande, et jamais son ui ; les commandes sont ajoutées au fur et à mesure que la télécommande les ajoute (pas de fenêtre). Les Dockerfile et docker/ (Compose, modèle d’Unraid) l’exécutent sur un serveur (server.md).

Le serveur s'exécute sur le runtime Tokio de l'application, un écouteur par adresse de réseau local. Chaque requête est vérifiée (Host, Origin, jeton), transformée en un mdm_ipc::Command marqué remote (un champ qu'aucune ligne de requête ne peut définir) et transmise à l'application via le même canal que la ligne de commande ; l'application y répond lors de sa prochaine image, comme elle répond à l'API d'automatisation. Sa page est intégrée (crates/remote/web) et ses textes proviennent des catalogues de l'application (remote.rs).

Traductions

Chaque texte affiché par l’interface utilisateur passe par crate::i18n (catalogues craft-i18n, i18n/<locale>.tsv). tools/i18n/extract.py reconstruit i18n/en.tsv à partir de la source, avec une note pour les traducteurs sur chaque texte (ce qu’il est, où il apparaît, ses espaces réservés). tools/i18n/translate.py complète ce qui manque aux autres catalogues (lignes marquées #, machine), en suivant le guide de style de chaque langue (i18n/style/) et le glossaire ; une ligne révisée par une personne n’est jamais remplacée, et CI (reviewed_guard.py) échoue à un changement qui en supprime une. Le site web a ses propres catalogues (i18n/site/, tools/website/translate_site.py).

Images

L’icône de l’application est dessinée à partir de la géométrie (tools/icon/dannex_logo.py ; build_icon.py écrit toutes les tailles, placées à la main sur des pixels entiers de 16 à 48 px). Chaque endroit qui l’affiche prend le dessin adapté à sa taille à l’écran (logo.rs) : sous Windows, les icônes de la barre de titre et de la barre des tâches de chaque fenêtre à l’échelle de son écran (win32::crisp_icons, qui les conserve aussi lors du passage sur un autre écran), celle de la zone de notification à l’échelle de la barre des tâches. Affichage → DDM Icône de la zone de notification l’affiche en pleine couleur (Style 3D) ou en symbole seul dans la couleur de la barre des tâches (Style plat : blanc sur une barre sombre, sombre sur une barre claire ; une image modèle sous macOS), avec une fine barre au bas de l’icône tant que des téléchargements sont en cours.

Les images des pages d’aide (docs/images/help/) proviennent d’une seule liste, tools/shots/shots.toml : tools/shots/make.py ouvre chaque fenêtre via la ligne de commande /show <window> de DDM dans une instance de test hors écran, la recadre et l’annote à partir de l’arbre d’accessibilité de la fenêtre, et écrit des WebP sans perte ; make.py check (CI) maintient la liste, les pages et les fichiers synchronisés. Les images publiées sont prises sur le runner Windows de GitHub (docs-shots.yml).

Contributeurs

tools/contributors.pylit qui a ouvert des pull requests et des problèmes, et qui a commenté, à partir de l'API publique de GitHub (le mainteneur, Claude et les bots sont exclus) pour chaque endroit qui les remercie : la page d'accueil du site web, /contributors.html et chaque version sur la page Nouveautés (build.py, sur chaque build), les notes de chaque version (release.yml, les personnes actives depuis la version précédente) et le README (python tools/contributors.py readme lors de la préparation de chaque version : ses photos rondes sont validées dans art/contributors/, car GitHub ne peut pas arrondir une image dans un README).

Tests et benchmarks

cargo testexécute des tests unitaires et des téléchargements de bout en bout contre mdm-labserver avec des pannes injectées (connexions lentes, interrompues et refusées, serveurs sans plages, fichiers changeants). tools/bench exécute la comparaison de vitesse publiée ; ses données brutes se trouvent dans docs/bench/.

Les images des fenêtres sont mesurées, pas estimées (crates/app/src/framestats.rs) : MDM_FRAME_STATS=1 consigne chaque seconde les passes de la fenêtre principale, combien venaient d’une saisie, ce qu’elles coûtent (la fenêtre principale, les fenêtres de progression, leur mise en page) et quelles lignes de code ont demandé les autres ; MDM_SYNTHETIC_LIST=10000 (avec un MDM_DATA_DIR de travail) ajoute autant de lignes fictives ; MDM_BENCH_SCROLL=10 fait défiler la liste seule pendant dix secondes et consigne la durée des images. Une fenêtre inactive n’a pas d’autres images que celles de son horloge (une toutes les 2 s) ; la liste ne génère que les lignes visibles.

Gratuit, open source, sans publicité ni période d’essai.

Télécharger Dannex Download Manager