1. Ana Sayfa
  2. Yardım
  3. Mimari

Mimari

How Matt Download Manager's pieces fit together.

Bileşenler

Yol Bileşen Rol
crates/engine mdm-engine HTTP(S) veya FTP(S) üzerinden tek bir dosyayı indirir: yoklama, segment planlayıcı, bağlantı çalışanları, devam durumu, ana bilgisayar başına sınırlar, hız sınırlayıcı, sağlama toplamları, proxy betikleri
crates/app mdm-app Masaüstü uygulaması (mattdownloadmanager.exe, egui): liste, kategoriler, kuyruklar, zamanlayıcı, iletişim kutuları, tepsi, ayarlar
crates/cli mdm-cli İlerleme bilgisiyle arayüzsüz indirmeler (get, resume), videolar, torrentler ve otomasyon API'sinin komutları: uygulamanın programının çalıştırdığı bir kütüphane (mattdownloadmanager --cli …) ve aynı argümanlarla başlatan, terminali ve çıkış kodunu paylaşan küçük bir başlatıcı (mattdownloadmanager-cli)
crates/mcp mdm-mcp MCP sunucusu (mattdownloadmanager-mcp): AI asistanları, çalışan uygulamanın indirmelerini otomasyon API'si aracılığıyla listeler, ekler ve kontrol eder
crates/remote mdm-remote Uzaktan kumanda (#141): yerel ağdaki eşleştirilmiş bir telefon veya bilgisayarın kullandığı HTTPS sunucusu (sayfası, eşleştirme kodları, cihaz belirteçleri, kendinden imzalı sertifika); her istek, uygulamanın yanıtladığı bir otomasyon API komutu haline gelir
crates/nmhost mdm-nmhost Tarayıcının yerel mesajlaşma ana bilgisayarı: yakalanan indirmeleri uzantıdan alır ve uygulamaya iletir
crates/ipc mdm-ipc Tek örnekli kanal (jeton korumalı yerel soket), veri klasörü ve uygulama ile ana bilgisayar tarafından paylaşılan yakalama kuralları
crates/debrid mdm-debrid Debrid hesapları (#44): hizmetlerin resmi API'leri (Real-Debrid, AllDebrid, Premiumize, TorBox, Mega-Debrid), bir dosya barındırıcısının bağlantısını motorun indirdiği doğrudan bir bağlantıya dönüştürür
crates/cnl mdm-cnl Click'n'Load 2 (#37): 127.0.0.1:9666 üzerindeki dinleyici, bir bağlantı sitesinin gönderilerini Bağlantı yakalayıcı için paketlere dönüştürür ve ne alacağı konusunda sınırlamalar getirir
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 İndirmenin sunucusunun konumu (#140): DB-IP'nin Lite verilerinden (tools/geo/build.py) oluşturulmuş, yalnızca bu bilgisayarda aranan bir IP'den ülkeye aralık tablosu ve ülkelerin bayrakları
crates/tools mdm-tools Video sayfaları yt-dlp ve ffmpeg aracılığıyla, resim galerileri gallery-dl aracılığıyla (ayrı programlar olarak çalıştırılır); bir ağ bağdaştırıcısı seçildiğinde, bağlantıları MDM'nin 127.0.0.1 üzerindeki bir proxy'si aracılığıyla ona bağlanır (relay.rs); her biri yazabileceği bir klasörde çalışır, aynı zamanda kendi TEMP klasöründe (workdir.rs)
crates/crash mdm-crash Çökme ve donma raporları: izleyici süreci, işlem dışı minidump'lar, sembolize edilmiş yığınlar, raporun metni ve sürüm günlükleri (crash-reports.md)
crates/torrent mdm-torrent librqbit aracılığıyla BitTorrent ve magnet bağlantıları
crates/labserver mdm-labserver İstek günlüğü ve hata enjeksiyonu olan bir HTTP Range sunucusu ve testler ve karşılaştırmalar için kendi hataları olan bir FTP/FTPS sunucusu
extension/ — Chromium (MV3) ve Firefox uzantısı
docs/ — Kullanım kılavuzu ve eğitimler, bu dosya, kıyaslama verileri; web sitesi kılavuzu Yardım'ın açtığı yardım sayfaları yapar
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

Bağımlılıklar içe doğru işaret eder: app, cli, mcp, nmhost ve remote, engine ve ipc kullanır; motor, kullanıcı arayüzü hakkında hiçbir şey bilmez. Uygulama, motoru yalnızca olayları (ilerleme, segment tablosu anlık görüntüleri, tamamlandı, başarısız oldu) aracılığıyla görür.

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

Her segment tamamlandığında, parça dosyası beklenen boyuta göre kontrol edilir ve yerine yeniden adlandırılır; dosyanın tarihi sunucunun tarihini takip edebilir.

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 ve FTPS (ftp.rs) aynı planlayıcı, çalışanlar ve durum üzerinden geçer: bir segment, aralıklı bir GET yerine bir kontrol oturumunda REST + RETR'tür, SIZE ve MDTM başlıklar için kullanılır ve oturumlar indirme başına havuza alınır ve segmentler arasında yeniden kullanılır.

Uygulama

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.

Temalar

Bir kontrolün çizildiği her renk ve boyut, etkin temadan (#45) gelir. Bir tema, açık ve koyu bir palet, ölçümler, kontrol stilleri ve bir simge stilidir (palette.rs):

  • Palet rolleri. palette.rs her rolü kararlı bir anahtarla ("button.hot", "list.row", "caption"…), bir açıklamayla ve klasik görünümün açık ve koyu değerleriyle (klasik görünüm türetilmemiştir) açıkça belirtir. Paylaşılan çiziciler (winui.rs, chrome.rs, list.rs, scrollbar.rs) bunları theme::colors() ve theme::metrics() aracılığıyla okur ve her kontrolün durumlarını bunlardan belirler; hiçbir çizim kodu kendi rengini tutmaz.
  • Türetilmiş paletler. derive.rs, birkaç çekirdekten (arka plan, yüzey, metin, vurgu…) tüm bir palet oluşturur, diğer tüm rolleri OKLab'da karıştırır ve WCAG kontrastını (metin için 4.5:1, kenarlar için 3:1) korur; Yüksek karşıtlık, her kenarı üstte güçlendirir. native.rs, Sistem temasını sistemin vurgu ve kontrastından (Windows ayarları, Linux'taki freedesktop portalı, macOS'un vurgusu) besler.
  • Denetim stilleri. palette::Controls her denetimin şeklini (metin kutuları, onay kutuları, düğmeler, ilerleme çubukları, kaydırma çubukları, odak işareti, başlık çubuğu) adlandırır; stil temaları (Metro, Adwaita, Breeze, Luna, Aero, Aqua, Emerald) kendilerini seçer ve Windows'ta MDM daha sonra başlık çubuğunu kendisi çizer (caption.* rolleri).
  • Tema dosyaları. themefile.rs, veri klasörünün themes içindeki TOML veya JSON'u okur (tek bir dosya veya yanında simgelerle birlikte <id>/theme.toml). Bir dosya yalnızca değiştirdiği şeyi adlandırır; geri kalanı inherits olduğu temadan (yerleşik bir temanın kimliği veya başka bir dosya, varsayılan olarak klasik görünüm) gelir, bir döngünün reddedildiği bir zincir boyunca. Bilinmeyen anahtarlar hata değil, uyarıdır. Yerleşik stil temaları da programda taşınan bu tür dosyalardır (crates/app/assets/themes).
  • Simge setleri. themeicons.rs, bir temanın simgelerini (ne için olduklarına göre adlandırılır: tb-add-url, cat-music…, 16, 24, 32 ve 48 pikselde SVG veya PNG, metin renginde mürekkep rengiyle çizilmiş -symbolic olanlar) klasik görünümün kendi simgelerini çizdiği yere çizer; setin eksik olduğu bir ihtiyaç, klasik simgeyi korur.

Bir pencerenin kontrollerini nereye koyduğu düzeni olarak kalır. Dosya adlarının önündeki simgeler de öyle (fileicons.rs): Windows kabuğunun sistem görüntü listeleri, macOS Finder'ın (NSWorkspace), Linux masaüstünün simge teması (xdgicons.rs, shared-mime-info ve Simge Teması Spesifikasyonu). Her tür, piksel boyutuna göre bir kez, bir arka plan iş parçacığında aranır. Tango'nun simgeleri (birlikte gelir), sistemin simgesi hazır olana kadar ve sistemde hiç simge yoksa kullanılır.

Çizim

Pencereler OpenGL (eframe'in glow'u) veya eframe'in wgpu aracılığıyla sistemin kendi grafik API'si ile, yalnızca o arka uçla çizilir: Windows'ta Direct3D 12 (orada varsayılan), Linux'ta Vulkan, macOS'ta Metal (orada seçenekler; gerçek grafik kartları onları denemeden önce OpenGL varsayılanları olarak kalır, #206). Görünüm → Şununla çiz, bir sonrakinden başlayarak birini seçer. Her sistemde tek bir kod yolu bunu yapar (crates/app/src/renderer.rs): seçilen başlatılamazsa, diğeri denenir, böylece pencereler her zaman açılır. Sistem API'si ile izlenen bir başlangıç, ilk çerçevesi çizilene kadar bir işaretleyici bırakır: bundan önce biten bir başlangıç (sürücü içinde bir çökme), ilk çerçevesi 10 saniye içinde gelmeyen bir başlangıç (MDM daha sonra OpenGL ile tekrar başlar) veya 10 dakika içinde iki kez kaybedilen bir grafik kartı, menünün gösterdiği nedeni ile hatırlanır.

Görünüm → Arayüz boyutu (scale.rs, #262), egui'nin ekranın kendi ölçeği üzerindeki yakınlaştırma faktörüdür: her pencere noktalarda düzenlenir, böylece o kadar daha büyük açılır; ekrandan daha büyük olan kaydırılır.

Veri

İndirme listesi ve ayarlar, veri klasörüne (downloads.json) atomik olarak kaydedilir: Windows'ta %APPDATA%\mattdownloadmanager\, Linux'ta ~/.local/share/mattdownloadmanager, macOS'ta ~/Library/Application Support/mattdownloadmanager, taşınabilir bir kopyanın yanında bir data klasörü veya MDM_DATA_DIR (mdm_ipc::data_dir). Tarayıcı ana bilgisayarı, yakalama kuralları için aynı dosyayı okur, böylece Seçenekler'deki bir değişiklik bir sonraki yakalanan indirmeye uygulanır.

Oturum açma sırları (debrid hesapları, Site oturum açma bilgileri ve proxy'nin parolaları) sistemin anahtar zincirinde (secrets.rs, #44) yaşar: Windows Kimlik Bilgileri Yöneticisi (win32.rs), Linux'ta Secret Service veya macOS anahtar zinciri (unix.rs). Ayarlar, anahtar zinciri sırrı onayladıktan sonra yalnızca bir kez yazılan keychain:<service>/<scope>/<key> referansını yerinde tutar; anahtar zinciri olmadan (veya MDM için asla kilidi açılmayan kilitli bir anahtar zinciriyle) sır, daha önce olduğu gibi ayarlarda kalır.

Bir indirmenin sunucu konumu (#140), bağlandığı adresin ülkesidir, bu bilgisayardaki mdm-geo tablosunda aranır (countries.rs arayüz dilinde adlandırır); sürüm işi, tablonun ayın verilerinden (tools/geo/build.py --release) yeniden oluşturur.

Tarayıcı entegrasyonu

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

Uzantı, ana bilgisayara hangi dosya türlerini alacağını sorar, her indirmeyi bunlara karşı kontrol eder ve tarayıcının indirmesini yalnızca uygulama kabul ettikten sonra iptal eder; aksi takdirde tarayıcı onu tutar ve uzantı nedenini söyler.

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.

Ana bilgisayar yalnızca MDM'nin kendi uzantısına hizmet verir. Kimlikleri tek bir yerdedir, mdm_ipc::extension (crates/ipc/src/extension.rs): paketi açılmış kopyanın (UNPACKED_ID, manifest'in genel anahtarından), Chrome Web Mağazası'nın (STORE_ID, mağazanın kendi anahtarıyla imzalanmıştır: pack.ps1, manifest'in anahtarını mağazanın kopyasından çıkarır), Firefox eklentisinin (FIREFOX_ID) ve addons.mozilla.org sayfasının; Edge ve Opera mağazalarının yer tutucuları vardır, uzantı orada listelenene kadar asla sunulmaz. Ana bilgisayar, bu kimliklerle her tarayıcının manifestini yazar ve uygulama, paketi açılmış olandan önce mağazanın kopyasını (Chrome'a Ekle, Firefox'a Ekle) sunar.

Uzaktan kumanda

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

--headless(headless.rs, #157) aynı App'yi eframe olmadan çalıştırır: bir döngü, komut kanalı tarafından uyandırılan çıplak bir egui::Context üzerinde tick'ünü (her karede logic'ün çalıştırdığı şey) çağırır ve asla ui'sını çağırmaz; komutlar, uzaktan kumandanın eklediği gibi eklenir (pencere yok). Dockerfile ve docker/ (Compose, Unraid'in şablonu) bunu bir sunucuda çalıştırır (server.md).

Sunucu, uygulamanın Tokio çalışma zamanında, yerel ağ adresine göre bir dinleyici ile çalışır. Her istek kontrol edilir (Host, Origin, belirteç), mdm_ipc::Command olarak işaretlenmiş remote (hiçbir istek satırının ayarlayamayacağı bir alan) haline getirilir ve komut satırınınkiyle aynı kanal aracılığıyla uygulamaya iletilir; uygulama, otomasyon API'sini yanıtladığı gibi, bir sonraki çerçevesinde yanıtlar. Sayfası crates/remote/web içinde oluşturulur ve metinleri uygulamanın kataloglarından (remote.rs) gelir.

Çeviriler

Kullanıcı arayüzünün gösterdiği her metin crate::i18n aracılığıyla geçer (craft-i18n katalogları, i18n/<locale>.tsv). tools/i18n/extract.py, i18n/en.tsv'ü kaynaktan yeniden oluşturur, her metin için çevirmenlere bir notla (ne olduğu, nerede gösterildiği, yer tutucuları). tools/i18n/translate.py, diğer katalogların eksiklerini ( #, machine ile işaretlenmiş satırlar) her dilin stil rehberine (i18n/style/) ve sözlüğe uygun olarak doldurur; bir kişinin incelediği bir satır asla değiştirilmez ve CI (reviewed_guard.py), bir satırı düşüren bir değişikliği başarısız kılar. Web sitesinin kendi katalogları vardır (i18n/site/, tools/website/translate_site.py).

Resimler

Yardım sayfalarının resimleri (docs/images/help/) tek bir listeden, tools/shots/shots.toml'den gelir: tools/shots/make.py, MDM'nin kendi /show <window> komut satırı aracılığıyla her pencereyi ekran dışı bir test örneğinde açar, pencerenin erişilebilirlik ağacından kırpar ve açıklama ekler ve kayıpsız WebP yazar; make.py check (CI), listeyi, sayfaları ve dosyaları senkronize tutar. Yayınlananlar GitHub'ın Windows çalıştırıcısında (docs-shots.yml) çekilir.

Katkıda bulunanlar

tools/contributors.pyGitHub'ın herkese açık API'sinden, katkıda bulunanları teşekkür eden her yerde (web sitesinin ana sayfası, /contributors.html ve Haberler sayfasındaki her sürüm (build.py, her derlemede), her sürümün notları (release.yml, önceki sürümden bu yana aktif olan kişiler) ve README (python tools/contributors.py readme her sürüm hazırlığında: yuvarlak fotoğrafları art/contributors/ içinde işlenir, çünkü GitHub bir README'deki bir resmi yuvarlayamaz) için çekme isteklerini ve sorunları kimin açtığını ve kimin yorum yaptığını okur (sürdürücü, Claude ve botlar hariç tutulur).

Testler ve karşılaştırmalar

cargo testYapay olarak oluşturulan hatalarla (yavaşlayan, kesilen ve reddedilen bağlantılar, aralık isteğini desteklemeyen sunucular, değişen dosyalar) mdm-labserver üzerinde birim testleri ve uçtan uca indirme testleri çalıştırır. tools/bench, yayımlanan hız karşılaştırmasını çalıştırır; ham veriler docs/bench/'tedir.

Ücretsiz, açık kaynak, reklamsız, deneme sürümü yok.

Matt Download Manager'ı indir