1. Inicio
  2. Ayuda
  3. Arquitectura

Arquitectura

How Matt Download Manager's pieces fit together.

Crates

Ruta Crate Función
crates/engine mdm-engine Descarga un archivo por HTTP(S) o FTP(S): sondeo, planificador de segmentos, trabajadores de conexión, estado de reanudación, límites por host, limitador de velocidad, sumas de comprobación, scripts de proxy
crates/app mdm-app La aplicación de escritorio (mattdownloadmanager.exe, egui): lista, categorías, colas, planificador, diálogos, bandeja, ajustes
crates/cli mdm-cli Descargas sin interfaz con progreso (get, resume), vídeos, torrents y los comandos de la API de automatización: una biblioteca que ejecuta el programa de la aplicación (mattdownloadmanager --cli …), y mattdownloadmanager-cli, un pequeño lanzador que la inicia con los mismos argumentos, terminal y código de salida
crates/mcp mdm-mcp El servidor MCP (mattdownloadmanager-mcp): los asistentes de IA listan, añaden y controlan las descargas de la aplicación en ejecución a través de la API de automatización
crates/remote mdm-remote El control remoto (#141): el servidor HTTPS que usa un teléfono o un ordenador emparejado en la red local (su página, códigos de emparejamiento, tokens de dispositivo, el certificado autofirmado); cada solicitud se convierte en un comando de la API de automatización que la aplicación responde
crates/nmhost mdm-nmhost El host de mensajería nativa del navegador: toma las descargas capturadas de la extensión y las entrega a la aplicación
crates/ipc mdm-ipc El canal de instancia única (un socket local protegido por token), la carpeta de datos y las reglas de captura compartidas por la aplicación y el host
crates/debrid mdm-debrid Cuentas Debrid (#44): las API oficiales de los servicios (Real-Debrid, AllDebrid, Premiumize, TorBox, Mega-Debrid) convierten un enlace de un servidor de archivos en uno directo que el motor descarga
crates/cnl mdm-cnl Click'n'Load 2 (#37): el detector en 127.0.0.1:9666 que lee las publicaciones de un sitio de enlaces y las convierte en paquetes para el Capturador de enlaces, con límites sobre lo que acepta
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 Ubicación del servidor de una descarga (#140): una tabla de rangos de IP a país construida a partir de los datos Lite de DB-IP (tools/geo/build.py), consultada solo en este equipo, y las banderas de los países
crates/tools mdm-tools Las páginas de vídeo, a través de yt-dlp y ffmpeg; las galerías de imágenes, a través de gallery-dl (se ejecutan como programas independientes). Cuando se elige un adaptador de red, sus conexiones pasan por un proxy de MDM en 127.0.0.1 que las vincula a él (relay.rs); cada uno se ejecuta en una carpeta en la que puede escribir, que también es su TEMP (workdir.rs).
crates/crash mdm-crash Informes de fallos y bloqueos: el proceso de monitorización, minivolcados fuera de proceso, pilas simbolizadas, el texto del informe y los registros de la versión (crash-reports.md)
crates/torrent mdm-torrent Enlaces BitTorrent y magnet a través de librqbit
crates/labserver mdm-labserver Un servidor HTTP Range con un registro de solicitudes e inyección de fallos, y un servidor FTP/FTPS con sus propios fallos, para pruebas y puntos de referencia
extension/ — La extensión para Chromium (MV3) y Firefox
docs/ — La guía de usuario y los tutoriales, este archivo, los datos de referencia; el sitio web convierte la guía en sus páginas de ayuda, que se abren con Ayuda
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

Las dependencias apuntan hacia dentro: app, cli, mcp, nmhost y remote usan engine y ipc; el motor no sabe nada de la interfaz de usuario. La aplicación ve el motor solo a través de sus eventos (progreso, instantáneas de la tabla de segmentos, finalizado, fallido).

Motor

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

Cuando cada segmento está hecho, el archivo parcial se comprueba con el tamaño esperado y se renombra en su lugar; la fecha del archivo puede seguir la del servidor.

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 y FTPS (ftp.rs) pasan por el mismo planificador, trabajadores y estado: un segmento es REST + RETR en una sesión de control en lugar de un GET con rango, SIZE y MDTM sustituyen a las cabeceras, y las sesiones se agrupan por descarga y se reutilizan entre segmentos.

Aplicación

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.

Temas

Cada color y tamaño con el que se dibuja un control proviene del tema activo (#45). Un tema es una paleta clara y una oscura, métricas, estilos de control y un estilo de icono (palette.rs):

  • Roles de paleta. palette.rs declara cada rol con una clave estable ("button.hot", "list.row", "caption"…), una descripción y los valores claros y oscuros del aspecto clásico, escritos (el aspecto clásico no se deriva). Los pintores compartidos (winui.rs, chrome.rs, list.rs, scrollbar.rs) los leen a través de theme::colors() y theme::metrics() y deciden los estados de cada control a partir de ellos; ningún código de pintura tiene un color propio.
  • Paletas derivadas. derive.rs crea una paleta completa a partir de unas pocas semillas (fondo, superficie, texto, acento…), mezclando todos los demás roles en OKLab y manteniendo el contraste WCAG (4,5:1 para texto, 3:1 para bordes); Contraste alto refuerza cada borde. native.rs siembra el tema Nativo a partir del acento y contraste del sistema (la configuración de Windows, el portal freedesktop en Linux, el acento de macOS).
  • Estilos de control. palette::Controls nombra la forma de cada control (cuadros de texto, casillas de verificación, botones, barras de progreso, barras de desplazamiento, la marca de enfoque, la barra de título); los temas de estilo (Metro, Adwaita, Breeze, Luna, Aero, Aqua, Emerald) eligen los suyos, y en Windows MDM dibuja la barra de título (los roles caption.*).
  • Archivos de tema. themefile.rs lee TOML o JSON de la carpeta de datos themes (un archivo, o <id>/theme.toml con iconos al lado). Un archivo nombra solo lo que cambia; el resto proviene del tema que inherits (el ID de uno integrado u otro archivo, el aspecto clásico por defecto), en una cadena en la que se rechaza un ciclo. Las claves desconocidas son advertencias, no errores. Los temas de estilo integrados también son esos archivos, incluidos en el programa (crates/app/assets/themes).
  • Conjuntos de iconos. themeicons.rs dibuja los iconos de un tema (nombrados por su función: tb-add-url, cat-music…, SVG o PNG a 16, 24, 32 y 48 px, los -symbolic entintados en el color del texto) donde el aspecto clásico dibuja los suyos; una necesidad que el conjunto no tiene mantiene el icono clásico.

La forma en que una ventana coloca sus controles mantiene su diseño. También lo hacen los iconos antes de los nombres de archivo (fileicons.rs): las listas de imágenes del sistema de la shell de Windows, las de macOS Finder (NSWorkspace), el tema de iconos del escritorio de Linux (xdgicons.rs, shared-mime-info y la Icon Theme Specification). Cada tipo se busca una vez por tamaño de píxel, en un hilo en segundo plano. Los iconos de Tango (incluidos) se usan hasta que el icono del sistema esté listo, y donde el sistema no tenga ninguno.

Dibujo

Las ventanas se dibujan con OpenGL (glow de eframe) o con la API de gráficos propia del sistema a través de wgpu de eframe, con ese único backend: Direct3D 12 en Windows (el predeterminado allí), Vulkan en Linux, Metal en macOS (opciones allí; OpenGL sigue siendo su predeterminado hasta que las tarjetas gráficas reales los hayan probado, #206). Ver → Dibujar con elige uno, a partir del siguiente inicio. Una ruta de código lo hace en cada sistema (crates/app/src/renderer.rs): cuando el elegido no puede iniciarse, se prueba el otro, por lo que las ventanas siempre se abren. Un inicio supervisado con la API del sistema deja un marcador hasta que se dibuja su primer fotograma: un inicio que termina antes (un fallo dentro del controlador), uno cuyo primer fotograma no llega en 10 segundos (MDM se reinicia con OpenGL), o una tarjeta gráfica perdida dos veces en 10 minutos se recuerda con su motivo, que el menú muestra.

Ver → Tamaño de la interfaz (scale.rs, #262) es el factor de zoom de egui sobre la escala propia de la pantalla: cada ventana se diseña en puntos, por lo que se abre mucho más grande; una más grande que la pantalla se desplaza.

Datos

La lista de descargas y la configuración se guardan atómicamente en la carpeta de datos (downloads.json): %APPDATA%\mattdownloadmanager\ en Windows, ~/.local/share/mattdownloadmanager en Linux, ~/Library/Application Support/mattdownloadmanager en macOS, una carpeta data junto a una copia portátil, o MDM_DATA_DIR (mdm_ipc::data_dir). El host del navegador lee el mismo archivo para las reglas de captura, por lo que un cambio en Opciones se aplica a la siguiente descarga capturada.

Los secretos de inicio de sesión (cuentas debrid, contraseñas de Inicios de sesión de sitios y del proxy) residen en el llavero del sistema (secrets.rs, #44): Administrador de credenciales de Windows (win32.rs), el Servicio Secreto en Linux o el llavero de macOS (unix.rs). La configuración mantiene una referencia keychain:<service>/<scope>/<key> en su lugar, escrita solo una vez que el llavero ha confirmado el secreto; sin un llavero (o con uno bloqueado, nunca desbloqueado para MDM) el secreto permanece en la configuración como antes.

La ubicación del servidor de una descarga (#140) es el país de la dirección a la que se conectó, buscada en la tabla de mdm-geo en este equipo (countries.rs la nombra en el idioma de la interfaz); el trabajo de lanzamiento reconstruye la tabla a partir de los datos del mes (tools/geo/build.py --release).

Integración con el navegador

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

La extensión pregunta al host qué tipos de archivo tomar, comprueba cada descarga con ellos y cancela la descarga del navegador solo después de que la aplicación la haya aceptado; de lo contrario, el navegador la mantiene y la extensión explica el 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.

El host solo sirve la extensión propia de MDM. Sus ID están en un solo lugar, mdm_ipc::extension (crates/ipc/src/extension.rs): la de la copia desempaquetada (UNPACKED_ID, de la clave pública del manifiesto), la de Chrome Web Store (STORE_ID, firmada con la clave propia de la tienda: pack.ps1 omite la clave del manifiesto de la copia de la tienda), la del complemento de Firefox (FIREFOX_ID) y su página addons.mozilla.org; las de las tiendas de Edge y Opera son marcadores de posición, nunca servidas, hasta que la extensión se liste allí. El host escribe el manifiesto de cada navegador con esos ID, y la aplicación ofrece la copia de la tienda (Añadir a Chrome, Añadir a Firefox) antes que la desempaquetada.

Control remoto

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

--headless(headless.rs, #157) ejecuta el mismo App sin eframe: un bucle llama a su tick (lo que logic ejecuta en cada fotograma) en un egui::Context desnudo, activado por el canal de comandos, y nunca a su ui; los comandos se añaden a medida que el control remoto los añade (sin ventana). Los Dockerfile y docker/ (Compose, plantilla de Unraid) lo ejecutan en un servidor (server.md).

El servidor se ejecuta en el tiempo de ejecución Tokio de la aplicación, un oyente por cada dirección de red local. Cada solicitud se comprueba (Host, Origin, token), se convierte en un mdm_ipc::Command marcado remote (un campo que ninguna línea de solicitud puede establecer) y se entrega a la aplicación a través del mismo canal que la línea de comandos; la aplicación la responde en su siguiente fotograma, como responde a la API de automatización. Su página está integrada (crates/remote/web) y sus textos provienen de los catálogos de la aplicación (remote.rs).

Traducciones

Cada texto que muestra la interfaz de usuario pasa por crate::i18n (catálogos craft-i18n, i18n/<locale>.tsv). tools/i18n/extract.py reconstruye i18n/en.tsv desde la fuente, con una nota para los traductores en cada texto (qué es, dónde se muestra, sus marcadores de posición). tools/i18n/translate.py rellena lo que falta en los otros catálogos (filas marcadas #, machine), siguiendo la guía de estilo de cada idioma (i18n/style/) y el glosario; una fila revisada por una persona nunca se reemplaza, y CI (reviewed_guard.py) falla un cambio que elimina una. El sitio web tiene sus propios catálogos (i18n/site/, tools/website/translate_site.py).

Imágenes

Las imágenes de las páginas de ayuda (docs/images/help/) provienen de una lista, tools/shots/shots.toml: tools/shots/make.py abre cada ventana a través de la línea de comandos /show <window> propia de MDM en una instancia de prueba fuera de la pantalla, la recorta y anota desde el árbol de accesibilidad de la ventana, y escribe WebP sin pérdidas; make.py check (CI) mantiene la lista, las páginas y los archivos sincronizados. Las publicadas se toman en el runner de Windows de GitHub (docs-shots.yml).

Colaboradores

tools/contributors.pylee quién abrió solicitudes de extracción e incidencias, y quién comentó, de la API pública de GitHub (el encargado del mantenimiento, Claude y los bots excluidos) para cada lugar que les da las gracias: la página de inicio del sitio web, /contributors.html y cada lanzamiento en la página de Novedades (build.py, en cada compilación), las notas de cada lanzamiento (release.yml, las personas activas desde el lanzamiento anterior) y el archivo README (python tools/contributors.py readme en la preparación de cada lanzamiento: sus fotos redondas se confirman en art/contributors/, ya que GitHub no puede redondear una imagen en un README).

Pruebas y puntos de referencia

cargo testejecuta pruebas unitarias y descargas de extremo a extremo contra mdm-labserver con fallos inyectados (conexiones lentas, caídas y rechazadas, servidores sin rangos, archivos cambiantes). tools/bench ejecuta la comparación de velocidad publicada; sus datos brutos están en docs/bench/.

Gratis, código abierto, sin anuncios, sin prueba.

Descargar Matt Download Manager