1. होम
  2. सहायता
  3. आर्किटेक्चर

आर्किटेक्चर

How Matt Download Manager's pieces fit together.

क्रेट्स

पाथ क्रेट भूमिका
crates/engine mdm-engine HTTP(S) या FTP(S) पर एक फ़ाइल डाउनलोड करता है: जांच, सेगमेंट प्लानर, कनेक्शन वर्कर, फिर से शुरू करने की स्थिति, प्रति-होस्ट सीमाएं, गति सीमक, चेकसम, प्रॉक्सी स्क्रिप्ट
crates/app mdm-app डेस्कटॉप ऐप (mattdownloadmanager.exe, egui): सूची, श्रेणियां, कतारें, शेड्यूलर, डायलॉग, ट्रे, सेटिंग्स
crates/cli mdm-cli प्रगति (get, resume), वीडियो, टोरेंट और ऑटोमेशन API के कमांड के साथ हेडलेस डाउनलोड: एक लाइब्रेरी जिसे ऐप का प्रोग्राम चलाता है (mattdownloadmanager --cli …), और mattdownloadmanager-cli, एक छोटा लॉन्चर जो इसे समान आर्ग्यूमेंट्स, टर्मिनल और एग्जिट कोड के साथ शुरू करता है
crates/mcp mdm-mcp MCP सर्वर (mattdownloadmanager-mcp): AI असिस्टेंट चल रहे ऐप के डाउनलोड को ऑटोमेशन API के माध्यम से सूचीबद्ध करते हैं, जोड़ते हैं और नियंत्रित करते हैं
crates/remote mdm-remote रिमोट कंट्रोल (#141): HTTPS सर्वर जिसका उपयोग स्थानीय नेटवर्क पर एक युग्मित फ़ोन या कंप्यूटर करता है (इसका पेज, युग्मन कोड, डिवाइस टोकन, सेल्फ-साइन किया गया प्रमाणपत्र); प्रत्येक अनुरोध एक ऑटोमेशन API कमांड बन जाता है जिसका ऐप जवाब देता है
crates/nmhost mdm-nmhost ब्राउज़र का नेटिव मैसेजिंग होस्ट: एक्सटेंशन से कैप्चर किए गए डाउनलोड लेता है और उन्हें ऐप को सौंपता है
crates/ipc mdm-ipc सिंगल-इंस्टेंस चैनल (एक टोकन-सुरक्षित लोकल सॉकेट), डेटा फ़ोल्डर, और ऐप और होस्ट द्वारा साझा किए गए कैप्चर नियम
crates/debrid mdm-debrid डीब्रिड खाते (#44): सेवाओं के आधिकारिक API (Real-Debrid, AllDebrid, Premiumize, TorBox, Mega-Debrid) एक फ़ाइल होस्ट के लिंक को एक डायरेक्ट लिंक में बदल देते हैं जिसे इंजन डाउनलोड करता है।
crates/cnl mdm-cnl Click'n'Load 2 (#37): 127.0.0.1:9666 पर सुनने वाला जो एक लिंक साइट के पोस्ट को लिंक ग्रैबर के लिए पैकेज में पढ़ता है, जिसमें यह क्या लेता है इसकी सीमाएँ होती हैं।
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 डाउनलोड का सर्वर कहाँ है (#140): DB-IP के लाइट डेटा (tools/geo/build.py) से बनी एक IP-से-देश रेंज तालिका, केवल इस कंप्यूटर पर देखी जाती है, और देशों के झंडे।
crates/tools mdm-tools वीडियो पेज yt-dlp और ffmpeg के माध्यम से, इमेज गैलरी gallery-dl के माध्यम से (अलग-अलग प्रोग्राम के रूप में चलते हैं); जब एक नेटवर्क एडाप्टर चुना जाता है, तो उनके कनेक्शन MDM के 127.0.0.1 पर एक प्रॉक्सी के माध्यम से जाते हैं जो उन्हें इससे बांधता है (relay.rs); प्रत्येक एक फ़ोल्डर में चलता है जिसे वह लिख सकता है, वह भी उसका TEMP (workdir.rs)
crates/crash mdm-crash क्रैश और फ्रीज़ रिपोर्ट: मॉनिटर प्रक्रिया, आउट-ऑफ-प्रोसेस मिनीडंप, सिंबॉलिकेटेड स्टैक, रिपोर्ट का टेक्स्ट और रिलीज़ लॉग (crash-reports.md)
crates/torrent mdm-torrent librqbit के माध्यम से BitTorrent और मैग्नेट लिंक
crates/labserver mdm-labserver अनुरोध लॉग और फ़ॉल्ट इंजेक्शन के साथ एक HTTP रेंज सर्वर, और परीक्षण और बेंचमार्क के लिए अपनी स्वयं की त्रुटियों के साथ एक FTP/FTPS सर्वर
extension/ — Chromium (MV3) और Firefox एक्सटेंशन
docs/ — उपयोगकर्ता मार्गदर्शिका और ट्यूटोरियल, यह फ़ाइल, बेंचमार्क डेटा; वेबसाइट इस मार्गदर्शिका को अपने सहायता पृष्ठ बनाती है, जिसे सहायता खोलता है
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

निर्भरताएँ अंदर की ओर इंगित करती हैं: app, cli, mcp, nmhost और remote, engine और ipc का उपयोग करते हैं; इंजन को UI के बारे में कुछ भी नहीं पता। ऐप इंजन को केवल उसकी घटनाओं (प्रगति, सेगमेंट तालिका स्नैपशॉट, समाप्त, विफल) के माध्यम से देखता है।

इंजन

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

जब हर सेगमेंट पूरा हो जाता है, तो पार्ट फ़ाइल की अपेक्षित आकार के विरुद्ध जांच की जाती है और उसे सही जगह पर नाम बदला जाता है; फ़ाइल की तारीख सर्वर के अनुसार हो सकती है।

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 और FTPS (ftp.rs) उसी प्लानर, वर्कर और स्थिति से होकर गुजरते हैं: एक सेगमेंट एक रेंज्ड GET के बजाय एक कंट्रोल सेशन पर REST + RETR होता है, SIZE और MDTM हेडर के लिए होते हैं, और सेशन प्रति डाउनलोड पूल किए जाते हैं और सेगमेंट के बीच पुन: उपयोग किए जाते हैं।

ऐप

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.

थीम

एक कंट्रोल को जिस भी रंग और आकार में खींचा जाता है, वह सक्रिय थीम (#45) से आता है। एक थीम एक हल्की और एक गहरी पैलेट, मेट्रिक्स, कंट्रोल स्टाइल और एक आइकन स्टाइल (palette.rs) होती है:

  • पैलेट भूमिकाएँ। palette.rs प्रत्येक भूमिका को एक स्थिर कुंजी ("button.hot", "list.row", "caption"…), एक विवरण और क्लासिक लुक के हल्के और गहरे मानों के साथ घोषित करता है, जो लिखे हुए होते हैं (क्लासिक लुक व्युत्पन्न नहीं है)। साझा पेंटर (winui.rs, chrome.rs, list.rs, scrollbar.rs) उन्हें theme::colors() और theme::metrics() के माध्यम से पढ़ते हैं और उनसे प्रत्येक कंट्रोल की स्थिति तय करते हैं; कोई भी पेंटिंग कोड अपना खुद का रंग नहीं रखता है।
  • व्युत्पन्न पैलेट। derive.rs कुछ बीज (पृष्ठभूमि, सतह, टेक्स्ट, एक्सेंट…) से एक पूरा पैलेट बनाता है, OKLab में हर दूसरी भूमिका को मिलाता है और WCAG कंट्रास्ट (टेक्स्ट के लिए 4.5:1, किनारों के लिए 3:1) बनाए रखता है; उच्च कंट्रास्ट हर किनारे को ऊपर से मजबूत करता है। native.rs सिस्टम के एक्सेंट और कंट्रास्ट (Windows की सेटिंग्स, Linux पर freedesktop पोर्टल, macOS का एक्सेंट) से नेटिव थीम को बीजता है।
  • नियंत्रण शैलियाँ। palette::Controls प्रत्येक नियंत्रण के आकार (टेक्स्ट बॉक्स, चेक बॉक्स, बटन, प्रगति बार, स्क्रॉल बार, फोकस मार्क, शीर्षक बार) का नाम देता है; शैली थीम (Metro, Adwaita, Breeze, Luna, Aero, Aqua, Emerald) अपनी पसंद चुनते हैं, और Windows पर MDM फिर शीर्षक बार को स्वयं खींचता है (caption.* भूमिकाएँ)।
  • थीम फ़ाइलें। themefile.rs डेटा फ़ोल्डर के themes से TOML या JSON पढ़ता है (एक फ़ाइल, या <id>/theme.toml जिसके बगल में आइकन होते हैं)। एक फ़ाइल केवल वही नाम देती है जो वह बदलती है; बाकी उस थीम से आता है जिसे वह inherits करता है (एक बिल्ट-इन की आईडी या कोई अन्य फ़ाइल, डिफ़ॉल्ट रूप से क्लासिक लुक), एक श्रृंखला में जिसमें एक चक्र को अस्वीकार कर दिया जाता है। अज्ञात कुंजियाँ चेतावनियाँ होती हैं, त्रुटियाँ नहीं। बिल्ट-इन स्टाइल थीम भी ऐसी फ़ाइलें होती हैं, जो प्रोग्राम में होती हैं (crates/app/assets/themes)।
  • आइकन सेट। themeicons.rs एक थीम के आइकन खींचता है (उनके उद्देश्य से नामित: tb-add-url, cat-music…, SVG या PNG 16, 24, 32 और 48 px पर, -symbolic वाले टेक्स्ट रंग में रंगे हुए) जहाँ क्लासिक लुक अपने खुद के खींचता है; एक आवश्यकता जो सेट में नहीं होती है, वह क्लासिक आइकन को रखती है।

एक विंडो अपने कंट्रोल कहाँ रखती है, वह उसका लेआउट रहता है। फ़ाइल नामों से पहले के आइकन भी (fileicons.rs): Windows शेल की सिस्टम इमेज लिस्ट, macOS फाइंडर की (NSWorkspace), Linux डेस्कटॉप की आइकन थीम (xdgicons.rs, shared-mime-info और आइकन थीम स्पेसिफिकेशन)। प्रत्येक प्रकार को प्रति पिक्सेल आकार एक बार, एक बैकग्राउंड थ्रेड पर देखा जाता है। टैंगो के आइकन (बंडल किए गए) तब तक खड़े रहते हैं जब तक सिस्टम का आइकन तैयार नहीं हो जाता, और जहाँ भी सिस्टम में कोई नहीं होता।

ड्राइंग

विंडो को OpenGL (eframe का ग्लो) या eframe के wgpu के माध्यम से सिस्टम के अपने ग्राफिक्स API के साथ, केवल उस एक बैकएंड के साथ खींचा जाता है: Windows पर Direct3D 12 (वहाँ डिफ़ॉल्ट), Linux पर Vulkan, macOS पर Metal (वहाँ विकल्प; OpenGL उनका डिफ़ॉल्ट रहता है जब तक वास्तविक ग्राफिक्स कार्ड ने उन्हें आज़माया नहीं है, #206)। देखें → इसके साथ ड्रा करें एक को चुनता है, अगली शुरुआत से। एक कोड पाथ इसे हर सिस्टम पर करता है (crates/app/src/renderer.rs): जब चुना हुआ शुरू नहीं हो पाता, तो दूसरा आज़माया जाता है, ताकि विंडो हमेशा खुलें। सिस्टम के API के साथ एक देखी गई शुरुआत तब तक एक मार्कर छोड़ती है जब तक उसका पहला फ्रेम खींचा नहीं जाता: एक शुरुआत जो उससे पहले समाप्त हो जाती है (ड्राइवर के अंदर एक क्रैश), एक जिसका पहला फ्रेम 10 सेकंड के भीतर नहीं आता (MDM फिर OpenGL के साथ फिर से शुरू होता है), या एक ग्राफिक्स कार्ड जो 10 मिनट में दो बार खो जाता है, उसे उसके कारण के साथ याद रखा जाता है, जिसे मेनू दिखाता है।

देखें → इंटरफ़ेस आकार (scale.rs, #262) डिस्प्ले के अपने स्केल पर egui का ज़ूम फैक्टर है: हर विंडो को पॉइंट्स में लेआउट किया जाता है, इसलिए वह उतनी ही बड़ी खुलती है; स्क्रीन से बड़ी वाली स्क्रॉल करती है।

डेटा

डाउनलोड सूची और सेटिंग्स को डेटा फ़ोल्डर (downloads.json) में परमाणु रूप से सहेजा जाता है: Windows पर %APPDATA%\mattdownloadmanager\, Linux पर ~/.local/share/mattdownloadmanager, macOS पर ~/Library/Application Support/mattdownloadmanager, एक पोर्टेबल कॉपी के बगल में एक data फ़ोल्डर, या MDM_DATA_DIR (mdm_ipc::data_dir)। ब्राउज़र होस्ट कैप्चर नियमों के लिए वही फ़ाइल पढ़ता है, इसलिए विकल्प में किया गया बदलाव अगले कैप्चर किए गए डाउनलोड पर लागू होता है।

साइन-इन रहस्य (डीब्रिड खाते, साइट लॉगिन और प्रॉक्सी के पासवर्ड) सिस्टम की कीचेन (secrets.rs, #44) में रहते हैं: Windows क्रेडेंशियल मैनेजर (win32.rs), Linux पर सीक्रेट सर्विस या macOS कीचेन (unix.rs)। सेटिंग्स अपने स्थान पर एक keychain:<service>/<scope>/<key> संदर्भ रखती हैं, जो केवल तभी लिखी जाती हैं जब कीचेन ने रहस्य की पुष्टि कर दी हो; कीचेन के बिना (या एक लॉक की गई कीचेन के साथ, MDM के लिए कभी अनलॉक नहीं की गई) रहस्य पहले की तरह सेटिंग्स में रहता है।

एक डाउनलोड का सर्वर स्थान (#140) उस पते का देश है जिससे वह जुड़ा था, इस कंप्यूटर पर mdm-geo की तालिका में देखा गया (countries.rs इसे इंटरफ़ेस भाषा में नाम देता है); रिलीज़ जॉब महीने के डेटा से तालिका को फिर से बनाता है (tools/geo/build.py --release)।

ब्राउज़र एकीकरण

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

एक्सटेंशन होस्ट से पूछता है कि कौन से फ़ाइल प्रकार लेने हैं, प्रत्येक डाउनलोड की उनके खिलाफ जाँच करता है, और ऐप द्वारा स्वीकार किए जाने के बाद ही ब्राउज़र के डाउनलोड को रद्द करता है; अन्यथा ब्राउज़र इसे रखता है, और एक्सटेंशन कारण बताता है।

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.

होस्ट केवल MDM के अपने एक्सटेंशन को सेवा देता है। इसकी ID एक ही जगह पर हैं, mdm_ipc::extension (crates/ipc/src/extension.rs): अनपैक्ड कॉपी की (UNPACKED_ID, मैनिफेस्ट की सार्वजनिक कुंजी से), Chrome वेब स्टोर की (STORE_ID, स्टोर की अपनी कुंजी से हस्ताक्षरित: pack.ps1 मैनिफेस्ट की कुंजी को स्टोर की कॉपी से बाहर रखता है), Firefox ऐड-ऑन की (FIREFOX_ID) और इसके addons.mozilla.org पेज की; Edge और Opera स्टोर की ID प्लेसहोल्डर हैं, कभी भी सेवा नहीं दी जाती, जब तक कि एक्सटेंशन वहाँ सूचीबद्ध न हो जाए। होस्ट उन ID के साथ प्रत्येक ब्राउज़र का मैनिफेस्ट लिखता है, और ऐप अनपैक्ड कॉपी से पहले स्टोर की कॉपी (Chrome में जोड़ें, Firefox में जोड़ें) प्रदान करता है।

रिमोट कंट्रोल

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

--headless(headless.rs, #157) eframe के बिना वही App चलाता है: एक लूप अपने tick को कॉल करता है (जो logic हर फ्रेम पर चलाता है) एक नंगे egui::Context पर, कमांड चैनल द्वारा जगाया जाता है, और कभी भी अपने ui को नहीं; कमांड वैसे ही जोड़े जाते हैं जैसे रिमोट कंट्रोल उन्हें जोड़ता है (कोई विंडो नहीं)। Dockerfile और docker/ (Compose, Unraid का टेम्पलेट) इसे एक सर्वर पर चलाते हैं (server.md)।

सर्वर ऐप के टोक्यो रनटाइम पर चलता है, प्रति स्थानीय नेटवर्क पते पर एक श्रोता। प्रत्येक अनुरोध की जाँच की जाती है (Host, Origin, टोकन), उसे mdm_ipc::Command के रूप में चिह्नित remote (एक फ़ील्ड जिसे कोई अनुरोध लाइन सेट नहीं कर सकती) में बदल दिया जाता है और कमांड लाइन के समान चैनल के माध्यम से ऐप को सौंप दिया जाता है; ऐप अपने अगले फ्रेम पर इसका जवाब देता है, जैसे वह ऑटोमेशन API का जवाब देता है। इसका पेज crates/remote/web में बनाया गया है और इसके टेक्स्ट ऐप के कैटलॉग (remote.rs) से आते हैं।

अनुवाद

UI द्वारा दिखाए गए हर टेक्स्ट crate::i18n (craft-i18n कैटलॉग, i18n/<locale>.tsv) के माध्यम से जाते हैं। tools/i18n/extract.py स्रोत से i18n/en.tsv को फिर से बनाता है, प्रत्येक टेक्स्ट पर अनुवादकों के लिए एक नोट के साथ (यह क्या है, यह कहाँ दिखाता है, इसके प्लेसहोल्डर)। tools/i18n/translate.py अन्य कैटलॉग में जो कमी है उसे भरता है (#, machine चिह्नित पंक्तियाँ), प्रत्येक भाषा की स्टाइल गाइड (i18n/style/) और शब्दावली का पालन करते हुए; एक पंक्ति जिसकी किसी व्यक्ति ने समीक्षा की है, उसे कभी नहीं बदला जाता है, और CI (reviewed_guard.py) एक ऐसे बदलाव को विफल करता है जो एक को छोड़ देता है। वेबसाइट के अपने कैटलॉग हैं (i18n/site/, tools/website/translate_site.py)।

चित्र

सहायता पृष्ठों के चित्र (docs/images/help/) एक सूची, tools/shots/shots.toml से आते हैं: tools/shots/make.py MDM के अपने /show <window> कमांड लाइन के माध्यम से प्रत्येक विंडो को स्क्रीन से दूर एक परीक्षण इंस्टेंस में खोलता है, विंडो के एक्सेसिबिलिटी ट्री से इसे क्रॉप और एनोटेट करता है, और दोषरहित WebP लिखता है; make.py check (CI) सूची, पृष्ठों और फ़ाइलों को एक साथ रखता है। प्रकाशित वाले GitHub के Windows रनर (docs-shots.yml) पर लिए जाते हैं।

योगदानकर्ता

tools/contributors.pyGitHub के सार्वजनिक API से यह पढ़ता है कि किसने पुल रिक्वेस्ट और इश्यू खोले, और किसने टिप्पणी की (रखरखावकर्ता, Claude और बॉट को छोड़कर), उन सभी जगहों के लिए जो उन्हें धन्यवाद देती हैं: वेबसाइट का होम पेज, /contributors.html और समाचार पेज पर प्रत्येक रिलीज़ (build.py, हर बिल्ड पर), प्रत्येक रिलीज़ के नोट्स (release.yml, पिछली रिलीज़ के बाद से सक्रिय लोग) और README (python tools/contributors.py readme प्रत्येक रिलीज़ की तैयारी में: इसकी गोल तस्वीरें art/contributors/ में कमिट की जाती हैं, क्योंकि GitHub README में किसी तस्वीर को गोल नहीं कर सकता)।

परीक्षण और बेंचमार्क

cargo testइंजेक्टेड फ़ॉल्ट्स (धीमे, छोड़े गए और अस्वीकृत कनेक्शन, बिना रेंज वाले सर्वर, बदलती फ़ाइलें) के साथ mdm-labserver के विरुद्ध यूनिट टेस्ट और एंड-टू-एंड डाउनलोड चलाता है। tools/bench प्रकाशित गति तुलना चलाता है; इसका कच्चा डेटा docs/bench/ में है।

मुफ़्त, ओपन सोर्स, कोई विज्ञापन नहीं, कोई ट्रायल नहीं।

Matt Download Manager डाउनलोड करें