Dannex Download Manager'ın parçaları nasıl bir araya geliyor.
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ı (dannexdownloadmanager.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 (dannexdownloadmanager --cli …) ve aynı argümanlarla başlatan, terminali ve çıkış kodunu paylaşan küçük bir başlatıcı (dannexdownloadmanager-cli) |
crates/mcp |
mdm-mcp |
MCP sunucusu (dannexdownloadmanager-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), 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/extract |
mdm-extract |
Arşiv çıkarma (#37): zip, tar, gz ve xz işlemde; 7z ve RAR, yüklü bir 7-Zip aracılığıyla kendi programı olarak çalıştırılır |
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ı DDM'nin 127.0.0.1 üzerindeki bir proxy'si aracılığıyla yönlendirilir ve bu proxy onları ona bağlar (relay.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/ |
— | dannex.kavangi.co.ke'un kendi sayfaları (ana sayfa, indirme, özellikler, temalar, SSS); tools/website/build.py, docs/'den yardım ve CHANGELOG'dan haberleri 22 dilde ekler ve GitHub Pages bunları yayınlar |
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.
Bir indirme işleminin ilk isteği (get), yönlendirmeleri ve bir dosyaya kendiliğinden götüren sayfaları (bekleme sayfasının yenilenmesi) takip eder. Bağlantıları dosyanın adresi olmayan siteler, sites/ içinde bir modüle sahiptir (Google Drive: sites/gdrive.rs): bu modül, bağlantıyı dosyanın adresine dönüştürür, sitenin kendi sayfalarını (bir onay formu, bir hata sayfası) okur ve ağ olmadan test edilen saf fonksiyonlarla reddetmelerini adlandırır (Error::Refused). Laboratuvar sunucusu, uçtan uca testler için böyle bir siteyi gerçek ana bilgisayar adlarında oynatır (labserver/src/drive.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
Sabit piksel koordinatlarına çizilmiş bir egui penceresi ve her iletişim kutusu için bir anlık görünüm penceresi. app.rs durumu (indirmeler, kuyruklar, ayarlar, listenin seçimi) tutar ve menü, araç çubuğu, tuş ve IPC komutlarını eylemlere dönüştürür. Her iletişim kutusu kendi modülüdür ve bir Outcome döndürür (açık, kapalı, bir değerle tamamlandı). Yalnızca Windows'a özgü çağrılar win32.rs ile sınırlıdır ve bunların Linux ve macOS karşılıkları unix.rs ile sınırlıdır (oturumdan başlayarak, tarayıcıların ana bilgisayarı, sesler, klasörde göster, çökme işleyicisi); diğer her dosya güvenli, taşınabilir Rust'tır. Yazı tipleri sistemden gelir: Windows'un Yazı Tipleri klasörü, macOS'un sistem yazı tipleri, Linux'ta fontconfig (theme.rs). Windows'ta, Latin, Yunan ve Kiril metinleri DirectWrite (win32.rs, egui'nin glif rasterleştirici kancası aracılığıyla) tarafından çizilir: Görünüm → Metin → Düzgün, doğal modunda, istenen boyutta kenar yumuşatmalı ve yazı tipinin kendi ilerlemeleriyle çeyrek piksellere yerleştirilmiş; Klasik (varsayılan) GDI-klasik modunda, böylece her harfin ipuçlu şekli ve tam piksel genişliği bir araya gelir. Diğer betikler egui tarafından şekillendirilir ve çizilir.
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 DDM 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. - Araç çubuğu simge stilleri. Görünüm → Araç Çubuğu → Çizgi stili (anahatlar, temanın belirlediği renkle çizilir) veya 3D stili: DDM'nin kendi parlak resimleri (
assets/icons/toolbar3d;tools/icon/toolbar_3d.pytarafından 16 ile 64 px arasında, ekrandaki boyuta uygun olanı çizilir; devre dışıykenicons.rsile grileştirilir). Temanın bir düğme için kendi simgesi yoksa ve simgelerini kendi renkleriyle çiziyorsa bu stiller geçerlidir; kendi simge takımı olan bir tema ya da simgeleri tek renkle çizen bir tema (Yüksek karşıtlık) kendi simgelerini 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ıç (DDM 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%\dannexdownloadmanager\, Linux'ta ~/.local/share/dannexdownloadmanager, macOS'ta ~/Library/Application Support/dannexdownloadmanager, 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 DDM 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.
Aynı yanıt, Seçenekler → Genel'in tuşlarını (keys: page.js'in bir tıklamayı hangi tuşla tuttuğu; bağlantıyı tarayıcıya bırakmak veya uygulamaya zorlamak için) ve gösterilecek sağ tık öğelerini (menu: değiştiklerinde background.js menüsünü yeniden oluşturur) taşır; video düğmesinin görünüp görünemeyeceğine verilen yanıt ise İndirme panelleri ayarlarını (panel: videoların veya ses oynatıcılarının üzerinde, en kısa süre, ilk köşe) taşır. Adları ve varsayılanları mdm_ipc::capture'a aittir ve uygulamanın kaydettiği ayarlardan okunur. Uzantı, tarayıcının penceresi odağı geri aldığında (en son sorduğundan birkaç saniye sonra), bir sayfa başladığında (15 sn) ve bir indirmede (bir dakika) yeniden sorar.
Araç çubuğu açılır penceresindeki indirme listesi (Duraklat, Sürdür, Klasörü aç) ve düğmedeki sayı, otomasyon API'sinin list ve eylemleridir; browser ayarlıyken ana bilgisayar üzerinden sorulur: uygulama, API'nin anahtarı ne olursa olsun bunları yanıtlar, video düğmesinin kalite menüsünü yanıtladığı gibi; ana bilgisayar bunlar için uygulamayı hiçbir zaman başlatmaz. Uzantı yalnızca açılır pencere açıkken veya indirmeler sürerken sorar.
Ana bilgisayar yalnızca DDM'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
Uygulama simgesi geometriden çizilir (tools/icon/dannex_logo.py; build_icon.py her boyutu, 16 ile 48 px arasında tam piksellere elle yerleştirerek yazar). Simgeyi gösteren her yer, ekrandaki boyutuna uygun çizimi alır (logo.rs): Windows'ta her pencerenin başlık çubuğu ve görev çubuğu simgeleri ekranının ölçeğinde (win32::crisp_icons; bu, başka bir ekrana taşınınca da korunmalarını sağlar), tepsi simgesi ise görev çubuğunun ölçeğinde. Görünüm → DDM Sistem tepsisi simgesi, onu tam renkli (3D stili) ya da yalnızca işareti görev çubuğunun mürekkep renginde (Düz stil: koyu görev çubuğunda beyaz, açık olanda koyu; macOS'ta şablon görüntü) gösterir; indirmeler sürerken alt kenarında ince bir çubuk bulunur.
Yardım sayfalarının resimleri (docs/images/help/) tek bir listeden, tools/shots/shots.toml'den gelir: tools/shots/make.py, DDM'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.
Pencerelerin kare süreleri tahmin edilmez, ölçülür (crates/app/src/framestats.rs): MDM_FRAME_STATS=1 her saniye ana pencerenin çizim turlarını, kaçının girdiden geldiğini, maliyetlerini (ana pencere, ilerleme pencereleri, yerleşimleri) ve diğerlerini hangi kod satırlarının istediğini günlüğe yazar; MDM_SYNTHETIC_LIST=10000 (geçici bir MDM_DATA_DIR ile) o kadar uydurma satır ekler; MDM_BENCH_SCROLL=10 listeyi on saniye boyunca kendiliğinden kaydırır ve karelerin sürelerini günlüğe yazar. Boştaki pencerenin saatinden başka karesi yoktur (2 sn'de bir); liste yalnızca görünen satırları çizer.
Ücretsiz, açık kaynak, reklamsız, deneme sürümü yok.
Dannex Download Manager'ı indir