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.rsdeclara 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 detheme::colors()ytheme::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.rscrea 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.rssiembra 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::Controlsnombra 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 rolescaption.*). - Archivos de tema.
themefile.rslee TOML o JSON de la carpeta de datosthemes(un archivo, o<id>/theme.tomlcon iconos al lado). Un archivo nombra solo lo que cambia; el resto proviene del tema queinherits(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.rsdibuja 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-symbolicentintados 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