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.rsher 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()vetheme::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::Controlsher 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ünthemesiç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ıinheritsolduğ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ş-symbolicolanlar) 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