Cómo encajan las piezas de Dannex Download Manager.
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 (dannexdownloadmanager.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 (dannexdownloadmanager --cli …), y dannexdownloadmanager-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 (dannexdownloadmanager-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 de debrid (#44): las API oficiales de los servicios (Real-Debrid, AllDebrid, Premiumize, TorBox) convierten un vínculo de un servidor de archivos en uno directo que el motor descarga |
crates/extract |
mdm-extract |
Extracción de archivos (#37): zip, tar, gz y xz en proceso; 7z y RAR a través de 7-Zip instalado, ejecutado como programa independiente |
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 (ejecutados como programas separados). Cuando se elige un adaptador de red, sus conexiones pasan por un proxy de DDM en 127.0.0.1 que las vincula a él (relay.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/ |
— | Las propias páginas de dannex.kavangi.co.ke (inicio, descarga, características, temas, preguntas frecuentes); tools/website/build.py añade la ayuda de docs/ y las noticias del CHANGELOG, en 22 idiomas, y GitHub Pages las publica |
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.
La primera solicitud de una descarga (get) sigue las redirecciones y las páginas que conducen a un archivo por sí mismas (la actualización de una página de espera). Los sitios cuyos enlaces no son la dirección del archivo tienen un módulo en sites/ (Google Drive: sites/gdrive.rs): este convierte el enlace en la dirección del archivo, lee las propias páginas del sitio (un formulario de confirmación, una página de error) y nombra sus rechazos (Error::Refused), con funciones puras probadas sin red. El servidor de laboratorio simula dicho sitio en sus nombres de host reales para las pruebas de extremo a extremo (labserver/src/drive.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
Una ventana de egui dibujada en coordenadas de píxeles fijas, más una ventana gráfica inmediata por cada diálogo. app.rs contiene el estado (descargas, colas, configuración, la selección de la lista) y convierte los comandos de menú, barra de herramientas, teclado e IPC en acciones. Cada diálogo es su propio módulo y devuelve un Outcome (abierto, cerrado, completado con un valor). Las llamadas exclusivas de Windows se limitan a win32.rs y sus equivalentes de Linux y macOS a unix.rs (a partir de la sesión, el host de los navegadores, los sonidos, mostrar en carpeta, el controlador de fallos); cualquier otro archivo es Rust seguro y portable. Las fuentes provienen del sistema: la carpeta Fonts de Windows, las fuentes del sistema de macOS, fontconfig en Linux (theme.rs). En Windows, el texto latino, griego y cirílico se dibuja con DirectWrite (win32.rs, a través del gancho del rasterizador de glifos de egui): Ver → Texto → Suave en su modo natural, con suavizado de contorno al tamaño solicitado y colocado en cuartos de píxel con los avances propios de la fuente; Clásico (el predeterminado) en modo GDI-classic, de modo que la forma sugerida y el ancho de píxel completo de cada letra se unen. Otros scripts son formados y dibujados por egui.
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 DDM 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. - Estilos de iconos de la barra de herramientas. Ver → Barra de herramientas → Estilo de líneas (los contornos, coloreados como indica el tema) o estilo 3D: las imágenes brillantes propias de DDM (
assets/icons/toolbar3d, dibujadas portools/icon/toolbar_3d.pyde 16 a 64 px, la del tamaño que se ve en pantalla; en gris conicons.rscuando están desactivadas). Se aplican donde el tema no tiene un icono propio para un botón y colorea sus iconos con sus propios colores; un tema con un conjunto de iconos, o uno que colorea los iconos de un solo color (Contraste alto), conserva los suyos.
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 (DDM 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%\dannexdownloadmanager\ en Windows, ~/.local/share/dannexdownloadmanager en Linux, ~/Library/Application Support/dannexdownloadmanager 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 DDM) 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.
La misma respuesta lleva las claves de Opciones → General (keys: lo que page.js usa para retener un clic, para dejar un enlace al navegador u obligarlo a pasar por la aplicación) y los elementos del menú contextual que se muestran (menu: background.js rehace su menú cuando cambian); la respuesta a si puede mostrarse el botón de vídeo lleva los ajustes de Paneles de descarga (panel: sobre vídeos o reproductores de sonido, la duración mínima, la primera esquina). Sus nombres y valores por defecto son los de mdm_ipc::capture, leídos de los ajustes que guarda la aplicación. La extensión vuelve a preguntar cuando la ventana del navegador recupera el foco (unos segundos después de la última vez), cuando se carga una página (15 s) y en una descarga (un minuto).
La lista de descargas de la ventana emergente de la barra de herramientas (Pausar, Reanudar, Abrir carpeta) y el número del botón son el list y las acciones de la API de automatización, consultados a través del host con browser establecido: la aplicación responde a esas peticiones sea cual sea el interruptor de la API, igual que responde al menú de calidad del botón de vídeo, y el host nunca inicia la aplicación para ellas. La extensión solo consulta mientras la ventana emergente está abierta o hay descargas en curso.
El host solo sirve la extensión propia de DDM. 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
El icono de la aplicación se dibuja a partir de geometría (tools/icon/dannex_logo.py; build_icon.py escribe todos los tamaños, colocados a mano en píxeles enteros de 16 a 48 px). Todos los lugares que lo muestran usan el dibujo para su tamaño en pantalla (logo.rs): en Windows, los iconos de la barra de título y de la barra de tareas de cada ventana, a la escala de su pantalla (win32::crisp_icons, que además los conserva al pasar a otra pantalla), y el de la bandeja, a la de la barra de tareas. Ver → DDM Icono de la bandeja lo muestra a todo color (estilo 3D) o solo la marca con el color de la barra de tareas (Estilo plano: blanca en una barra de tareas oscura, oscura en una clara; una imagen de plantilla en macOS), con una barra fina en la base mientras hay descargas en curso.
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 DDM 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/.
Los fotogramas de las ventanas se miden, no se adivinan (crates/app/src/framestats.rs): MDM_FRAME_STATS=1 registra cada segundo las pasadas de la ventana principal, cuántas vinieron de una entrada, lo que costaron (la ventana principal, las ventanas de progreso, su diseño) y qué líneas de código pidieron las demás; MDM_SYNTHETIC_LIST=10000 (con un MDM_DATA_DIR de prueba) añade esa cantidad de filas inventadas; MDM_BENCH_SCROLL=10 desplaza la lista por sí solo durante diez segundos y registra los tiempos de los fotogramas. Una ventana inactiva no tiene más fotogramas que los de su reloj (uno cada 2 s); la lista solo dibuja las filas visibles.
Gratis, código abierto, sin anuncios, sin prueba.
Descargar Dannex Download Manager