1. Beranda
  2. Bantuan
  3. Arsitektur

Arsitektur

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.rs mendeklarasikan 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 melalui theme::colors() dan theme::metrics() dan memutuskan status setiap kontrol darinya; tidak ada kode lukisan yang memiliki warna sendiri.
  • Palet turunan. derive.rs membuat 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.rs memberi benih tema Sistem dari aksen dan kontras sistem (pengaturan Windows, portal freedesktop di Linux, aksen macOS).
  • Gaya kontrol. palette::Controls menamai 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 (peran caption.*).
  • File tema. themefile.rs membaca TOML atau JSON dari folder data themes (satu file, atau <id>/theme.toml dengan ikon di sampingnya). Sebuah file hanya menamai apa yang diubahnya; sisanya berasal dari tema yang inherits (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.rs menggambar ikon tema (dinamai berdasarkan fungsinya: tb-add-url, cat-music…, SVG atau PNG pada 16, 24, 32, dan 48 px, -symbolic yang 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