How Matt Download Manager's pieces fit together.
Crates
| Jalur | Crate | Peran |
|---|---|---|
crates/engine |
mdm-engine |
Mengunduh satu berkas melalui HTTP(S) atau FTP(S): probe, perencana segmen, pekerja koneksi, status lanjutkan, batas per host, pembatas kecepatan, checksum, skrip proxy |
crates/app |
mdm-app |
Aplikasi desktop (mattdownloadmanager.exe, egui): daftar, kategori, antrean, penjadwal, dialog, baki, pengaturan |
crates/cli |
mdm-cli |
Unduhan tanpa antarmuka dengan progres (get, resume), video, torrent, dan perintah API otomatisasi: pustaka yang dijalankan oleh program aplikasi (mattdownloadmanager --cli …), dan mattdownloadmanager-cli, peluncur kecil yang memulainya dengan argumen, terminal, dan kode keluar yang sama |
crates/mcp |
mdm-mcp |
Server MCP (mattdownloadmanager-mcp): asisten AI dapat melihat, menambahkan, dan mengontrol unduhan aplikasi yang sedang berjalan melalui API otomatisasi |
crates/remote |
mdm-remote |
Kontrol jarak jauh (#141): server HTTPS yang digunakan ponsel atau komputer yang dipasangkan di jaringan lokal (halamannya, kode pemasangan, token perangkat, sertifikat yang ditandatangani sendiri); setiap permintaan menjadi perintah API otomatisasi yang dijawab aplikasi |
crates/nmhost |
mdm-nmhost |
Host pesan asli peramban: mengambil unduhan yang ditangkap dari ekstensi dan menyerahkannya ke aplikasi |
crates/ipc |
mdm-ipc |
Saluran satu instans (soket lokal yang dilindungi token), folder data, dan aturan penangkapan yang dibagikan oleh aplikasi dan host |
crates/debrid |
mdm-debrid |
Akun debrid (#44): API resmi layanan (Real-Debrid, AllDebrid, Premiumize, TorBox, Mega-Debrid) mengubah tautan host file menjadi tautan langsung yang diunduh oleh mesin |
crates/cnl |
mdm-cnl |
Click'n'Load 2 (#37): pendengar di 127.0.0.1:9666 yang membaca postingan situs tautan ke dalam paket untuk Link grabber, dengan batasan pada apa yang diambilnya |
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 |
Lokasi server unduhan (#140): tabel rentang IP-ke-negara yang dibuat dari data DB-IP Lite (tools/geo/build.py), dicari hanya di komputer ini, dan bendera negara |
crates/tools |
mdm-tools |
Halaman video melalui yt-dlp dan ffmpeg, galeri gambar melalui gallery-dl (berjalan sebagai program terpisah); saat adaptor jaringan dipilih, koneksi mereka melewati proxy MDM di 127.0.0.1 yang mengikatnya (relay.rs); setiap program berjalan di folder yang dapat ditulisnya, juga TEMP-nya (workdir.rs) |
crates/crash |
mdm-crash |
Laporan kerusakan dan macet: proses monitor, minidump di luar proses, tumpukan bersimbol, teks laporan dan log rilis (crash-reports.md) |
crates/torrent |
mdm-torrent |
BitTorrent dan tautan magnet melalui librqbit |
crates/labserver |
mdm-labserver |
Server HTTP Range dengan log permintaan dan injeksi kesalahan, dan server FTP/FTPS dengan kesalahannya sendiri, untuk pengujian dan tolok ukur |
extension/ |
— | Ekstensi Chromium (MV3) dan Firefox |
docs/ |
— | Panduan pengguna dan tutorial, berkas ini, data benchmark; situs web menjadikan panduan sebagai halaman bantuannya, yang dibuka oleh Bantuan |
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 |
Ketergantungan mengarah ke dalam: app, cli, mcp, nmhost, dan remote menggunakan engine dan ipc; mesin tidak tahu apa-apa tentang UI. Aplikasi hanya melihat mesin melalui kejadiannya (kemajuan, cuplikan tabel segmen, selesai, gagal).
Mesin
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
Setelah semua segmen selesai, file sementara diperiksa apakah ukurannya sesuai harapan, lalu dipindahkan ke lokasi akhir dengan nama yang sesuai; tanggal file dapat mengikuti tanggal dari server.
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 dan FTPS (ftp.rs) menggunakan perencana, pekerja, dan status yang sama: segmen berupa REST + RETR pada sesi kontrol, bukan GET; SIZE dan MDTM berjangka digunakan sebagai pengganti header, dan sesi dikumpulkan per unduhan serta digunakan kembali antarsegmen.
Aplikasi
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.
Tema
Setiap warna dan ukuran kontrol digambar berasal dari tema aktif (#45). Sebuah tema adalah palet terang dan gelap, metrik, gaya kontrol, dan gaya ikon (palette.rs):
- Peran palet.
palette.rsmendeklarasikan setiap peran dengan kunci stabil ("button.hot","list.row","caption"…), deskripsi, dan nilai terang serta gelap tampilan klasik, dituliskan (tampilan klasik tidak diturunkan). Pelukis bersama (winui.rs,chrome.rs,list.rs,scrollbar.rs) membacanya melaluitheme::colors()dantheme::metrics()dan memutuskan status setiap kontrol darinya; tidak ada kode lukisan yang memiliki warna sendiri. - Palet turunan.
derive.rsmembuat seluruh palet dari beberapa benih (latar belakang, permukaan, teks, aksen…), mencampur setiap peran lain di OKLab dan menjaga kontras WCAG (4.5:1 untuk teks, 3:1 untuk tepi); Kontras tinggi memperkuat setiap tepi di atasnya.native.rsmemberi benih tema Sistem dari aksen dan kontras sistem (pengaturan Windows, portal freedesktop di Linux, aksen macOS). - Gaya kontrol.
palette::Controlsmenamai bentuk setiap kontrol (kotak teks, kotak centang, tombol, bilah kemajuan, bilah gulir, tanda fokus, bilah judul); tema gaya (Metro, Adwaita, Breeze, Luna, Aero, Aqua, Emerald) memilih gayanya, dan di Windows MDM kemudian menggambar bilah judul itu sendiri (perancaption.*). - File tema.
themefile.rsmembaca TOML atau JSON dari folder datathemes(satu file, atau<id>/theme.tomldengan ikon di sampingnya). Sebuah file hanya menamai apa yang diubahnya; sisanya berasal dari tema yanginherits(ID bawaan atau file lain, tampilan klasik secara default), menyusuri rantai di mana siklus ditolak. Kunci yang tidak dikenal adalah peringatan, bukan kesalahan. Tema gaya bawaan juga merupakan file semacam itu, dibawa dalam program (crates/app/assets/themes). - Set ikon.
themeicons.rsmenggambar ikon tema (dinamai berdasarkan fungsinya:tb-add-url,cat-music…, SVG atau PNG pada 16, 24, 32, dan 48 px,-symbolicyang diwarnai dengan warna teks) di mana tampilan klasik menggambar ikonnya sendiri; kebutuhan yang tidak dimiliki set akan mempertahankan ikon klasik.
Di mana jendela menempatkan kontrolnya tetap menjadi tata letaknya. Begitu juga ikon sebelum nama file (fileicons.rs): daftar gambar sistem shell Windows, Finder macOS (NSWorkspace), tema ikon desktop Linux (xdgicons.rs, shared-mime-info dan Spesifikasi Tema Ikon). Setiap jenis dicari sekali per ukuran piksel, pada utas latar belakang. Ikon Tango (dibundel) berfungsi sampai ikon sistem siap, dan di mana pun sistem tidak memilikinya.
Menggambar
Jendela digambar dengan OpenGL (glow eframe) atau dengan API grafis sistem sendiri melalui wgpu eframe, dengan hanya satu backend itu: Direct3D 12 di Windows (default di sana), Vulkan di Linux, Metal di macOS (pilihan di sana; OpenGL tetap menjadi default mereka sampai kartu grafis sungguhan mencobanya, #206). Tampilan → Render dengan memilih salah satu, dari awal berikutnya. Satu jalur kode melakukannya di setiap sistem (crates/app/src/renderer.rs): ketika yang dipilih tidak dapat dimulai, yang lain dicoba, sehingga jendela selalu terbuka. Mulai yang diawasi dengan API sistem meninggalkan penanda sampai bingkai pertamanya digambar: mulai yang berakhir sebelumnya (crash di dalam driver), yang bingkai pertamanya tidak datang dalam 10 detik (MDM kemudian mulai lagi dengan OpenGL), atau kartu grafis yang hilang dua kali dalam 10 menit diingat dengan alasannya, yang ditunjukkan menu.
Tampilan → Ukuran antarmuka (scale.rs, #262) adalah faktor zoom egui di atas skala tampilan sendiri: setiap jendela ditata dalam poin, sehingga terbuka lebih besar; yang lebih besar dari layar akan menggulir.
Data
Daftar unduhan dan pengaturan disimpan secara atomik ke folder data (downloads.json): %APPDATA%\mattdownloadmanager\ di Windows, ~/.local/share/mattdownloadmanager di Linux, ~/Library/Application Support/mattdownloadmanager di macOS, folder data di samping salinan portabel, atau MDM_DATA_DIR (mdm_ipc::data_dir). Host browser membaca file yang sama untuk aturan pengambilan, sehingga perubahan di Opsi berlaku untuk unduhan yang diambil berikutnya.
Rahasia masuk (akun debrid, Login Situs, dan kata sandi proxy) disimpan di rantai kunci sistem (secrets.rs, #44): Windows Credential Manager (win32.rs), Secret Service di Linux atau rantai kunci macOS (unix.rs). Pengaturan menyimpan referensi keychain:<service>/<scope>/<key> di tempatnya, ditulis hanya setelah rantai kunci mengonfirmasi rahasia; tanpa rantai kunci (atau dengan yang terkunci, tidak pernah dibuka untuk MDM) rahasia tetap ada di pengaturan seperti sebelumnya.
Lokasi server unduhan (#140) adalah negara dari alamat yang terhubung, dicari di tabel mdm-geo di komputer ini (countries.rs menamainya dalam bahasa antarmuka); tugas rilis membangun kembali tabel dari data bulan itu (tools/geo/build.py --release).
Integrasi browser
page ──► extension ──native messaging──► mdm-nmhost ──ipc──► app
Ekstensi meminta host jenis file apa yang akan diambil, memeriksa setiap unduhan terhadapnya, dan membatalkan unduhan browser hanya setelah aplikasi menerimanya; jika tidak, browser menyimpannya, dan ekstensi mengatakan alasannya.
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.
Host hanya melayani ekstensi MDM sendiri. ID-nya ada di satu tempat, mdm_ipc::extension (crates/ipc/src/extension.rs): salinan yang belum dikemas (UNPACKED_ID, dari kunci publik manifes), Chrome Web Store (STORE_ID, ditandatangani dengan kunci toko sendiri: pack.ps1 meninggalkan kunci manifes dari salinan toko), add-on Firefox (FIREFOX_ID) dan halaman addons.mozilla.org-nya; toko Edge dan Opera adalah placeholder, tidak pernah dilayani, sampai ekstensi terdaftar di sana. Host menulis manifes setiap browser dengan ID tersebut, dan aplikasi menawarkan salinan toko (Tambah ke Chrome, Tambah ke Firefox) sebelum yang belum dikemas.
Kontrol jarak jauh
phone ──HTTPS (paired token)──► mdm-remote ──ipc::Sink──► app (answer, remote_add)
--headless(headless.rs, #157) menjalankan App yang sama tanpa eframe: sebuah loop memanggil tick-nya (apa yang dijalankan logic di setiap bingkai) pada egui::Context kosong, dibangunkan oleh saluran perintah, dan tidak pernah ui-nya; perintah ditambahkan saat remote control menambahkannya (tanpa jendela). Dockerfile dan docker/ (Compose, template Unraid) menjalankannya di server (server.md).
Server berjalan pada runtime Tokio aplikasi, satu pendengar per alamat jaringan lokal. Setiap permintaan diperiksa (Host, Origin, token), diubah menjadi mdm_ipc::Command yang ditandai remote (bidang yang tidak dapat diatur oleh baris permintaan) dan diserahkan ke aplikasi melalui saluran yang sama dengan baris perintah; aplikasi menjawabnya pada bingkai berikutnya, seperti halnya menjawab API otomatisasi. Halamannya dibuat di dalam (crates/remote/web) dan teksnya berasal dari katalog aplikasi (remote.rs).
Terjemahan
Setiap teks yang ditampilkan UI melewati crate::i18n (katalog craft-i18n, i18n/<locale>.tsv). tools/i18n/extract.py membangun kembali i18n/en.tsv dari sumber, dengan catatan untuk penerjemah pada setiap teks (apa itu, di mana ditampilkan, placeholder-nya). tools/i18n/translate.py mengisi apa yang tidak dimiliki katalog lain (baris yang ditandai #, machine), mengikuti panduan gaya setiap bahasa (i18n/style/) dan glosarium; baris yang ditinjau seseorang tidak pernah diganti, dan CI (reviewed_guard.py) menggagalkan perubahan yang menghapus satu. Situs web memiliki katalognya sendiri (i18n/site/, tools/website/translate_site.py).
Gambar
Gambar halaman bantuan (docs/images/help/) berasal dari satu daftar, tools/shots/shots.toml: tools/shots/make.py membuka setiap jendela melalui baris perintah /show <window> MDM sendiri dalam instans uji di luar layar, memotong dan menganotasinya dari pohon aksesibilitas jendela, dan menulis WebP lossless; make.py check (CI) menjaga daftar, halaman, dan file tetap sinkron. Yang dipublikasikan diambil di runner Windows GitHub (docs-shots.yml).
Kontributor
tools/contributors.pymembaca siapa yang membuka permintaan tarik dan isu, dan siapa yang berkomentar, dari API publik GitHub (pemelihara, Claude, dan bot tidak disertakan) untuk setiap tempat yang berterima kasih kepada mereka: halaman beranda situs web, /contributors.html dan setiap rilis di halaman Berita (build.py, pada setiap build), catatan setiap rilis (release.yml, orang-orang yang aktif sejak rilis sebelumnya) dan README (python tools/contributors.py readme pada persiapan setiap rilis: foto bulatnya di-commit di art/contributors/, karena GitHub tidak dapat membulatkan gambar di README).
Pengujian dan tolok ukur
cargo testmenjalankan pengujian unit dan unduhan ujung-ke-ujung terhadap mdm-labserver dengan kesalahan yang disuntikkan (koneksi lambat, terputus, dan ditolak, server tanpa rentang, berkas yang berubah). tools/bench menjalankan perbandingan kecepatan yang diterbitkan; data mentahnya ada di docs/bench/.
Gratis, sumber terbuka, tanpa iklan, tanpa masa uji coba.
Unduh Matt Download Manager