Como as partes do Dannex Download Manager se encaixam.
Crates
| Caminho | Crate | Função |
|---|---|---|
crates/engine |
mdm-engine |
Baixa um arquivo via HTTP(S) ou FTP(S): sonda, planejador de segmentos, workers de conexão, estado de retomada, limites por host, limitador de velocidade, somas de verificação, scripts de proxy |
crates/app |
mdm-app |
O aplicativo para desktop (dannexdownloadmanager.exe, egui): lista, categorias, filas, agendador, caixas de diálogo, bandeja do sistema, configurações |
crates/cli |
mdm-cli |
Downloads sem interface com progresso (get, resume), vídeos, torrents e os comandos da API de automação: uma biblioteca que o programa do aplicativo executa (dannexdownloadmanager --cli …), e dannexdownloadmanager-cli, um pequeno iniciador que a executa com os mesmos argumentos, terminal e código de saída |
crates/mcp |
mdm-mcp |
O servidor MCP (dannexdownloadmanager-mcp): assistentes de IA podem listar, adicionar e controlar os downloads do aplicativo em execução por meio da API de automação |
crates/remote |
mdm-remote |
O controle remoto (#141): o servidor HTTPS que um telefone ou computador emparelhado na rede local usa (sua página, códigos de emparelhamento, tokens de dispositivo, o certificado autoassinado); cada solicitação se torna um comando da API de automação que o aplicativo responde |
crates/nmhost |
mdm-nmhost |
O host de mensagens nativas do navegador: recebe downloads capturados da extensão e os entrega ao aplicativo |
crates/ipc |
mdm-ipc |
O canal de instância única (um socket local protegido por token), a pasta de dados e as regras de captura compartilhadas pelo aplicativo e pelo host |
crates/debrid |
mdm-debrid |
Contas Debrid (#44): as APIs oficiais dos serviços (Real-Debrid, AllDebrid, Premiumize, TorBox) transformam um link de um host de arquivos em um link direto que o motor de download baixa |
crates/extract |
mdm-extract |
Extração de arquivos compactados (#37): zip, tar, gz e xz em processo; 7z e RAR por meio de um 7-Zip instalado, executado como programa próprio |
crates/geo |
mdm-geo |
Localização do servidor de um download (#140): uma tabela de faixas de IP para país, construída a partir dos dados Lite do DB-IP (tools/geo/build.py), consultada apenas neste computador, e as bandeiras dos países |
crates/tools |
mdm-tools |
Páginas de vídeo processadas por yt-dlp e ffmpeg, galerias de imagens processadas por gallery-dl (executados como programas separados); enquanto um adaptador de rede estiver selecionado, as conexões desses programas passam por um proxy do DDM em 127.0.0.1, que as vincula a esse adaptador (relay.rs) |
crates/crash |
mdm-crash |
Relatórios de falhas e travamentos: o processo de monitoramento, minidumps fora do processo, pilhas simbolizadas, o texto do relatório e os logs de lançamento (crash-reports.md) |
crates/torrent |
mdm-torrent |
BitTorrent e links magnet por meio de librqbit |
crates/labserver |
mdm-labserver |
Um servidor HTTP Range com um log de requisições e injeção de falhas, e um servidor FTP/FTPS com suas próprias falhas, para testes e benchmarks |
extension/ |
— | A extensão para Chromium (MV3) e Firefox |
docs/ |
— | O guia do usuário e os tutoriais, este arquivo, os dados de benchmark; o site transforma o guia em suas páginas de ajuda, que Ajuda abre |
website/ |
— | As próprias páginas do dannex.kavangi.co.ke (início, download, recursos, temas, FAQ); tools/website/build.py adiciona a ajuda de docs/ e as notícias do CHANGELOG, em 22 idiomas, e o GitHub Pages as publica |
As dependências apontam para dentro: app, cli, mcp, nmhost e remote usam engine e ipc; o motor não sabe nada da interface do usuário. O aplicativo vê o motor apenas através de seus eventos (progresso, instantâneos da tabela de segmentos, concluído, falhou).
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
Quando todos os segmentos são concluídos, o arquivo temporário é verificado em relação ao tamanho esperado e renomeado para o nome definitivo; a data do arquivo pode ser definida de acordo com a do servidor.
A primeira solicitação de um download (get) segue redirecionamentos e páginas que levam automaticamente a um arquivo (como a atualização de uma página de espera). Sites cujos links não apontam diretamente para o arquivo têm um módulo em sites/ (Google Drive: sites/gdrive.rs): ele transforma o link no endereço do arquivo, lê as páginas do próprio site (como um formulário de confirmação ou uma página de erro) e identifica os motivos de recusa (Error::Refused). As funções puras são testadas sem rede. O servidor de laboratório simula esse tipo de site usando os nomes reais dos hosts para os testes de ponta a ponta (labserver/src/drive.rs).
FTP e FTPS (ftp.rs) usam o mesmo planejador, os mesmos workers e o mesmo estado: um segmento é REST + RETR em uma sessão de controle, em vez de um GET com intervalo; SIZE e MDTM substituem os cabeçalhos; as sessões são agrupadas por download e reutilizadas entre segmentos.
Aplicativo
Uma janela egui pintada em coordenadas de pixel fixas, mais uma viewport imediata por diálogo. app.rs mantém o estado (downloads, filas, configurações, a seleção da lista) e transforma comandos de menu, barra de ferramentas, teclado e IPC em ações. Cada diálogo é seu próprio módulo e retorna um Outcome (aberto, fechado, concluído com um valor). Chamadas exclusivas do Windows são confinadas a win32.rs e suas contrapartes Linux e macOS a unix.rs (começando com a sessão, o host dos navegadores, sons, mostrar na pasta, o manipulador de falhas); todos os outros arquivos são Rust seguro e portátil. As fontes vêm do sistema: pasta Fonts do Windows, fontes do sistema do macOS, fontconfig no Linux (theme.rs). No Windows, texto latino, grego e cirílico é desenhado por DirectWrite (win32.rs, através do hook do rasterizador de glifos do egui): Exibir → Texto → Suave em seu modo natural, com anti-aliasing no tamanho solicitado e posicionado em quartos de pixel com os avanços da própria fonte; Clássico (o padrão) no modo GDI-clássico, para que a forma hintada e a largura de pixel inteiro de cada letra se unam. Outros scripts são formatados e desenhados pelo egui.
Temas
Cada cor e tamanho com que um controle é desenhado vêm do tema ativo (#45). Um tema é uma paleta clara e escura, métricas, estilos de controle e um estilo de ícone (palette.rs):
- Funções da paleta.
palette.rsdeclara cada função com uma chave estável ("button.hot","list.row","caption"…), uma descrição e os valores claros e escuros da aparência clássica, escritos (a aparência clássica não é derivada). Os pintores compartilhados (winui.rs,chrome.rs,list.rs,scrollbar.rs) os leem através detheme::colors()etheme::metrics()e decidem os estados de cada controle a partir deles; nenhum código de pintura mantém uma cor própria. - Paletas derivadas.
derive.rscria uma paleta completa a partir de algumas sementes (fundo, superfície, texto, destaque…), misturando todas as outras funções em OKLab e mantendo o contraste WCAG (4.5:1 para texto, 3:1 para bordas); o Alto contraste reforça cada borda por cima.native.rssemeia o tema Nativo a partir do destaque e contraste do sistema (configurações do Windows, o portal freedesktop no Linux, o destaque do macOS). - Estilos de controle.
palette::Controlsnomeia a forma de cada controle (caixas de texto, caixas de seleção, botões, barras de progresso, barras de rolagem, a marca de foco, a barra de título); os temas de estilo (Metro, Adwaita, Breeze, Luna, Aero, Aqua, Emerald) escolhem os seus, e no Windows o DDM então desenha a própria barra de título (as funçõescaption.*). - Arquivos de tema.
themefile.rslê TOML ou JSON da pasta de dadosthemes(um arquivo, ou<id>/theme.tomlcom ícones ao lado). Um arquivo nomeia apenas o que ele muda; o resto vem do tema que eleinherits(um ID de um tema embutido ou outro arquivo, a aparência clássica por padrão), em uma cadeia na qual um ciclo é recusado. Chaves desconhecidas são avisos, não erros. Os temas de estilo embutidos também são esses arquivos, carregados no programa (crates/app/assets/themes). - Conjuntos de ícones.
themeicons.rsdesenha os ícones de um tema (nomeados pelo que são:tb-add-url,cat-music…, SVG ou PNG em 16, 24, 32 e 48 px,-symboliccoloridos na cor do texto) onde a aparência clássica desenha os seus; uma necessidade que o conjunto não tem mantém o ícone clássico. - Estilos de ícones da barra de ferramentas. Exibir → Barra de Ferramentas → Estilo de linha (os contornos, coloridos como o tema determina) ou Estilo 3D: as imagens brilhantes do próprio DDM (
assets/icons/toolbar3d, desenhadas portools/icon/toolbar_3d.pyde 16 a 64 px, a do tamanho em uso na tela; em cinza poricons.rsquando desativadas). Valem onde o tema não tem ícone próprio para um botão e colore os ícones com as cores deles; um tema com conjunto de ícones, ou que colore os ícones com uma só cor (Alto contraste), mantém o seu.
Onde uma janela coloca seus controles permanece seu layout. O mesmo acontece com os ícones antes dos nomes de arquivo (fileicons.rs): as listas de imagens do sistema do shell do Windows, do Finder do macOS (NSWorkspace), o tema de ícones da área de trabalho do Linux (xdgicons.rs, shared-mime-info e a Especificação de Tema de Ícones). Cada tipo é consultado uma vez por tamanho de pixel, em um thread em segundo plano. Os ícones do Tango (incluídos) são usados até que o ícone do sistema esteja pronto, e onde o sistema não tiver nenhum.
Desenho
As janelas são desenhadas com OpenGL (glow do eframe) ou com a própria API gráfica do sistema através do wgpu do eframe, com apenas esse backend: Direct3D 12 no Windows (o padrão lá), Vulkan no Linux, Metal no macOS (opções lá; OpenGL permanece o padrão até que placas de vídeo reais os tenham testado, #206). Exibir → Desenhar com escolhe um, a partir do próximo início. Um caminho de código faz isso em todos os sistemas (crates/app/src/renderer.rs): quando o escolhido não consegue iniciar, o outro é tentado, para que as janelas sempre abram. Um início monitorado com a API do sistema deixa um marcador até que seu primeiro quadro seja desenhado: um início que termina antes disso (uma falha dentro do driver), um cujo primeiro quadro não aparece em 10 segundos (o DDM então reinicia com OpenGL), ou uma placa de vídeo perdida duas vezes em 10 minutos é lembrada com sua razão, que o menu mostra.
Exibir → Tamanho da interface (scale.rs, #262) é o fator de zoom do egui sobre a escala própria da tela: cada janela é disposta em pontos, então ela abre muito maior; uma maior que a tela rola.
Dados
A lista de downloads e as configurações são salvas atomicamente na pasta de dados (downloads.json): %APPDATA%\dannexdownloadmanager\ no Windows, ~/.local/share/dannexdownloadmanager no Linux, ~/Library/Application Support/dannexdownloadmanager no macOS, uma pasta data ao lado de uma cópia portátil, ou MDM_DATA_DIR (mdm_ipc::data_dir). O host do navegador lê o mesmo arquivo para as regras de captura, então uma mudança em Opções se aplica ao próximo download capturado.
Segredos de login (contas debrid, senhas de Logins de Sites e do proxy) ficam no chaveiro do sistema (secrets.rs, #44): Gerenciador de Credenciais do Windows (win32.rs), o Secret Service no Linux ou o chaveiro do macOS (unix.rs). As configurações mantêm uma referência keychain:<service>/<scope>/<key> em seu lugar, escrita apenas uma vez que o chaveiro tenha confirmado o segredo; sem um chaveiro (ou com um bloqueado, nunca desbloqueado para o DDM) o segredo permanece nas configurações como antes.
A localização do servidor de um download (#140) é o país do endereço ao qual ele se conectou, consultado na tabela de mdm-geo neste computador (countries.rs o nomeia no idioma da interface); o trabalho de lançamento reconstrói a tabela a partir dos dados do mês (tools/geo/build.py --release).
Integração com o navegador
page ──► extension ──native messaging──► mdm-nmhost ──ipc──► app
A extensão pergunta ao host quais tipos de arquivo aceitar, verifica cada download em relação a eles e cancela o download do navegador somente depois que o aplicativo o aceitou; caso contrário, o navegador o mantém, e a extensão diz o porquê.
A mesma resposta traz as teclas de Opções → Geral (keys: com o que page.js reconhece um clique, para deixar um link com o navegador ou forçá-lo para o app) e os itens do menu de clique direito a mostrar (menu: background.js refaz o menu quando eles mudam); a resposta sobre se o botão de vídeo pode aparecer traz as configurações de Painéis de download (panel: sobre vídeos ou players de áudio, a duração mínima, o primeiro canto). Os nomes e os valores padrão são os de mdm_ipc::capture, lidos das configurações que o app salva. A extensão pergunta de novo quando a janela do navegador volta a receber o foco (alguns segundos depois da última pergunta), quando uma página começa (15 s) e em um download (um minuto).
A lista de downloads do pop-up da barra de ferramentas (Pausar, Retomar, Abrir pasta) e o número no botão são o list e as ações da API de automação, pedidos pelo host com browser definido: o app os atende seja qual for a chave da API, como atende o menu de qualidades do botão de vídeo, e o host nunca inicia o app por causa deles. A extensão só pergunta enquanto o pop-up está aberto ou há downloads em andamento.
O host serve apenas a própria extensão do DDM. Seus IDs estão em um só lugar, mdm_ipc::extension (crates/ipc/src/extension.rs): o da cópia descompactada (UNPACKED_ID, da chave pública do manifesto), o da Chrome Web Store (STORE_ID, assinado com a própria chave da loja: pack.ps1 omite a chave do manifesto da cópia da loja), o do complemento do Firefox (FIREFOX_ID) e sua página addons.mozilla.org; os das lojas Edge e Opera são placeholders, nunca servidos, até que a extensão seja listada lá. O host escreve o manifesto de cada navegador com esses IDs, e o aplicativo oferece a cópia da loja (Adicionar ao Chrome, Adicionar ao Firefox) antes da descompactada.
Controle remoto
phone ──HTTPS (paired token)──► mdm-remote ──ipc::Sink──► app (answer, remote_add)
--headless(headless.rs, #157) executa o mesmo App sem eframe: um loop chama seu tick (o que logic executa a cada quadro) em um egui::Context nu, acordado pelo canal de comando, e nunca seu ui; os comandos são adicionados conforme o controle remoto os adiciona (sem janela). O Dockerfile e o docker/ (Compose, template do Unraid) o executam em um servidor (server.md).
O servidor é executado no tempo de execução Tokio do aplicativo, um ouvinte por endereço de rede local. Cada solicitação é verificada (Host, Origin, token), transformada em um mdm_ipc::Command marcado remote (um campo que nenhuma linha de solicitação pode definir) e entregue ao aplicativo através do mesmo canal da linha de comando; o aplicativo a responde em seu próximo quadro, assim como responde à API de automação. Sua página é incorporada (crates/remote/web) e seus textos vêm dos catálogos do aplicativo (remote.rs).
Traduções
Todo texto que a UI mostra passa por crate::i18n (catálogos craft-i18n, i18n/<locale>.tsv). tools/i18n/extract.py reconstrói i18n/en.tsv da fonte, com uma nota para tradutores em cada texto (o que é, onde aparece, seus placeholders). tools/i18n/translate.py preenche o que os outros catálogos não têm (linhas marcadas #, machine), seguindo o guia de estilo de cada idioma (i18n/style/) e o glossário; uma linha revisada por uma pessoa nunca é substituída, e o CI (reviewed_guard.py) falha em uma mudança que a remove. O site tem seus próprios catálogos (i18n/site/, tools/website/translate_site.py).
Imagens
O ícone do app é desenhado a partir de geometria (tools/icon/dannex_logo.py; build_icon.py grava todos os tamanhos, posicionados à mão em pixels inteiros de 16 a 48 px). Todo lugar que o mostra usa o desenho do tamanho em uso na tela (logo.rs): no Windows, os ícones da barra de título e da barra de tarefas de cada janela na escala da tela dela (win32::crisp_icons, que também os mantém ao mover para outra tela), o da bandeja na escala da barra de tarefas. Exibir → DDM Ícone da bandeja o mostra em cores (Estilo 3D) ou só a marca na cor da barra de tarefas (Estilo plano: branco em barra escura, escuro em barra clara; uma imagem de modelo no macOS), com uma barra fina na base enquanto há downloads em andamento.
As imagens das páginas de ajuda (docs/images/help/) vêm de uma lista, tools/shots/shots.toml: tools/shots/make.py abre cada janela através da própria linha de comando /show <window> do DDM em uma instância de teste fora da tela, a recorta e anota a partir da árvore de acessibilidade da janela, e escreve WebP sem perdas; make.py check (CI) mantém a lista, as páginas e os arquivos em sincronia. As publicadas são tiradas no runner do Windows do GitHub (docs-shots.yml).
Colaboradores
tools/contributors.pylê quem abriu pull requests e issues, e quem comentou, da API pública do GitHub (o mantenedor, Claude e bots são excluídos) para cada lugar que os agradece: a página inicial do site, /contributors.html e cada lançamento na página Notícias (build.py, em cada compilação), as notas de cada lançamento (release.yml, as pessoas ativas desde o lançamento anterior) e o README (python tools/contributors.py readme na preparação de cada lançamento: suas fotos redondas são commitadas em art/contributors/, já que o GitHub não consegue arredondar uma imagem em um README).
Testes e benchmarks
cargo testexecuta testes de unidade e downloads de ponta a ponta contra mdm-labserver com falhas injetadas (conexões lentas, perdidas e recusadas, servidores sem intervalos, arquivos em mudança). tools/bench executa a comparação de velocidade publicada; seus dados brutos estão em docs/bench/.
Os quadros das janelas são medidos, não estimados (crates/app/src/framestats.rs): MDM_FRAME_STATS=1 registra, a cada segundo, os quadros da janela principal, quantos vieram de ações do usuário, quanto custaram (a janela principal, as janelas de progresso, o layout delas) e quais linhas de código pediram os demais; MDM_SYNTHETIC_LIST=10000 (com um MDM_DATA_DIR de teste) adiciona essa quantidade de linhas inventadas; MDM_BENCH_SCROLL=10 rola a lista sozinho por dez segundos e registra os tempos dos quadros. Uma janela ociosa só tem os quadros do seu relógio (um a cada 2 s); a lista só desenha as linhas visíveis.
Gratuito, de código aberto, sem anúncios, sem período de teste.
Baixar Dannex Download Manager