Dannex Download Manager の各部分がどのように連携するか。
クレート
| パス | クレート | 役割 |
|---|---|---|
crates/engine |
mdm-engine |
HTTP(S)またはFTP(S)経由で1つのファイルをダウンロード: プローブ、セグメントプランナー、接続ワーカー、レジューム状態、ホストごとの制限、速度制限、チェックサム、プロキシスクリプト |
crates/app |
mdm-app |
デスクトップアプリ (dannexdownloadmanager.exe、egui): リスト、カテゴリ、キュー、スケジューラ、ダイアログ、トレイ、設定 |
crates/cli |
mdm-cli |
進捗状況 (get、resume) を表示するヘッドレスダウンロード、動画、トレント、自動化 API のコマンド: アプリのプログラムが実行するライブラリ (dannexdownloadmanager --cli …) と、同じ引数、ターミナル、終了コードでそのプログラムを起動する小さなランチャー (dannexdownloadmanager-cli) |
crates/mcp |
mdm-mcp |
MCP サーバー (dannexdownloadmanager-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) は、ファイル ホストのリンクをエンジンがダウンロードする直接リンクに変換します。 |
crates/extract |
mdm-extract |
アーカイブの展開 (#37): zip、tar、gz、xz は処理中。7z と RAR はインストール済みの 7-Zip を別のプログラムとして実行して処理します。 |
crates/geo |
mdm-geo |
ダウンロード サーバーの場所 (#140): DB-IP の Lite データ (tools/geo/build.py) から構築された IP-国範囲テーブルをこのコンピューターでのみ検索し、国の旗を表示します。 |
crates/tools |
mdm-tools |
yt-dlp と ffmpeg による動画ページの処理、gallery-dl による画像ギャラリーの処理 (それぞれ別のプログラムとして実行)。ネットワークアダプターが選択されている間、これらの接続は 127.0.0.1 上にある DDM のプロキシを経由し、そのアダプターを使用します (relay.rs) |
crates/crash |
mdm-crash |
クラッシュおよびフリーズレポート: モニタープロセス、プロセス外ミニダンプ、シンボル化されたスタック、レポートテキスト、リリースログ (crash-reports.md) |
crates/torrent |
mdm-torrent |
librqbitによるBitTorrentおよびマグネットリンク |
crates/labserver |
mdm-labserver |
リクエストログと障害注入機能を備えたHTTP Rangeサーバー、および独自の障害を備えたFTP/FTPSサーバー (テストおよびベンチマーク用) |
extension/ |
— | Chromium (MV3) およびFirefox拡張機能 |
docs/ |
— | ユーザーガイドとチュートリアル、このファイル、ベンチマークデータ。ウェブサイトはガイドをヘルプページとしており、ヘルプで開きます |
website/ |
— | dannex.kavangi.co.ke のページ (ホーム、ダウンロード、機能、テーマ、FAQ)。tools/website/build.py が docs/ のヘルプと CHANGELOG のニュースを 22 言語で追加し、GitHub Pages が公開します。 |
依存関係は内側を指します。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
すべてのセグメントが完了すると、部分ファイルは期待されるサイズと照合され、所定の場所に名前が変更されます。ファイルの作成日はサーバーの作成日に従うことができます。
ダウンロードの最初のリクエスト (get) は、リダイレクトや、ファイルに直接つながるページ (待機ページの更新) に従います。リンクがファイルの直接のアドレスではないサイトには、sites/ にモジュールがあります (Google Drive: sites/gdrive.rs)。これはリンクをファイルのアドレスに変換し、サイト自身のページ (確認フォーム、エラーページ) を読み取り、拒否理由に名前を付けます (Error::Refused)。これらはネットワークなしでテストされた純粋な関数です。ラボサーバーは、エンドツーエンドテスト (labserver/src/drive.rs) のために、実際のホスト名でそのようなサイトをシミュレートします。
FTP と FTPS (ftp.rs) は、同じプランナー、ワーカー、状態管理を使用します。セグメントは、範囲指定した GET の代わりに制御セッション上で REST + RETR を使用し、SIZE と MDTM がヘッダーの役割を果たします。セッションはダウンロードごとにプールされ、セグメント間で再利用されます。
アプリ
固定ピクセル座標に描画された egui ウィンドウが 1 つと、ダイアログごとに即時ビューポートが 1 つあります。app.rs は状態 (ダウンロード、キュー、設定、リストの選択) を保持し、メニュー、ツールバー、キー、IPC コマンドをアクションに変換します。各ダイアログは独自のモジュールであり、Outcome (開いている、閉じている、値で完了) を返します。Windows 専用の呼び出しは win32.rs に限定され、Linux および macOS の対応する呼び出しは unix.rs に限定されます (セッション、ブラウザーのホスト、サウンド、フォルダーに表示、クラッシュ ハンドラーから開始)。その他のすべてのファイルは安全でポータブルな Rust です。フォントはシステムから取得されます: Windows の Fonts フォルダー、macOS のシステム フォント、Linux の fontconfig (theme.rs)。Windows では、ラテン文字、ギリシャ文字、キリル文字のテキストは DirectWrite (win32.rs、egui のグリフ ラスタライザー フックを介して) によって描画されます: [表示]→[テキスト]→[スムーズ]は自然なモードで、要求されたサイズでアンチエイリアスされ、フォント独自の進みで 4 分の 1 ピクセルに配置されます。[クラシック](既定) は GDI クラシック モードで、各文字のヒント付き形状と全ピクセル幅が結合されます。その他のスクリプトは egui によって整形および描画されます。
テーマ
コントロールの描画に使用されるすべての色とサイズは、アクティブなテーマ (#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は各コントロールの形状 (テキスト ボックス、チェック ボックス、ボタン、進行状況バー、スクロール バー、フォーカス マーク、タイトル バー) を指定します。スタイル テーマ (メトロ、Adwaita、Breeze、Luna、Aero、Aqua、Emerald) はそれらを選択し、Windows では DDM がタイトル バー自体を描画します (caption.*の役割)。 - テーマ ファイル。
themefile.rsは、データ フォルダーのthemesから TOML または JSON を読み取ります (1 つのファイル、またはアイコンが隣接する<id>/theme.toml)。ファイルは変更する内容のみに名前を付けます。残りはinheritsするテーマ (組み込みの ID または別のファイル、デフォルトではクラシックな外観) から取得され、サイクルが拒否されるチェーンをたどります。不明なキーはエラーではなく警告です。組み込みのスタイル テーマも、プログラムに含まれるそのようなファイルです (crates/app/assets/themes)。 - アイコン セット。
themeicons.rsは、クラシックな外観が独自のアイコンを描画する場所に、テーマのアイコン (用途別に名前が付けられています:tb-add-url、cat-music…、16、24、32、48 px の SVG または PNG、テキストの色でインク付けされた-symbolic) を描画します。セットに不足している要件はクラシック アイコンを保持します。 - ツールバー アイコンのスタイル。表示 → ツールバー → ライン スタイル (線画で、色はテーマに従います) または 3D スタイル: DDM 独自の光沢のある絵です (
assets/icons/toolbar3d。tools/icon/toolbar_3d.pyが 16 ~ 64 px で描き、画面上のサイズに合うものを使います。無効のときはicons.rsでグレーにします)。テーマがボタン用の独自のアイコンを持たず、アイコンを自身の色で描く場合に適用されます。アイコン セットを持つテーマや、アイコンを 1 色で描くテーマ (ハイ コントラスト) では、そのテーマのアイコンが使われます。
ウィンドウがコントロールを配置する場所はレイアウトのままです。ファイル名の前のアイコン (fileicons.rs) も同様です。Windows シェルのシステム イメージ リスト、macOS Finder (NSWorkspace)、Linux デスクトップのアイコン テーマ (xdgicons.rs、shared-mime-info、Icon Theme Specification)。各タイプは、ピクセル サイズごとに 1 回、バックグラウンド スレッドで検索されます。Tango のアイコン (バンドルされています) は、システムのアイコンが準備できるまで、またシステムにアイコンがない場所では常に表示されます。
描画
ウィンドウは OpenGL (eframe の glow) または eframe の wgpu を介してシステムのグラフィック API で描画され、そのバックエンドのみを使用します。Windows では Direct3D 12 (デフォルト)、Linux では Vulkan、macOS では Metal (選択肢があります。OpenGL は、実際のグラフィック カードがそれらを試すまでデフォルトのままです、#206)。表示 → 描画方法 で 1 つを選択し、次回の起動から適用されます。1 つのコード パスがすべてのシステムでこれを実行します (crates/app/src/renderer.rs)。選択したものが起動できない場合、もう 1 つが試行されるため、ウィンドウは常に開きます。システムの API で監視された起動は、最初のフレームが描画されるまでマーカーを残します。それより前に終了する起動 (ドライバー内のクラッシュ)、最初のフレームが 10 秒以内に表示されない起動 (DDM は OpenGL で再起動します)、または 10 分以内にグラフィック カードが 2 回失われた場合は、その理由が記憶され、メニューに表示されます。
表示 → インターフェイスのサイズ (scale.rs、#262) は、ディスプレイ自体のスケールに対する egui のズーム係数です。すべてのウィンドウはポイントでレイアウトされるため、その分だけ大きく開きます。画面より大きい場合はスクロールします。
データ
ダウンロード リストと設定は、データ フォルダー (downloads.json) にアトミックに保存されます。Windows では %APPDATA%\dannexdownloadmanager\、Linux では ~/.local/share/dannexdownloadmanager、macOS では ~/Library/Application Support/dannexdownloadmanager、ポータブル コピーの横にある data フォルダー、または MDM_DATA_DIR (mdm_ipc::data_dir) です。ブラウザー ホストはキャプチャ ルールに同じファイルを読み取るため、オプションでの変更は次回のキャプチャされたダウンロードに適用されます。
サインイン シークレット (デブリッド アカウント、サイトのログイン、プロキシのパスワード) はシステムのキーチェーン (secrets.rs、#44) に保存されます。Windows 資格情報マネージャー (win32.rs)、Linux の Secret Service、または macOS のキーチェーン (unix.rs) です。設定は、キーチェーンがシークレットを確認した後にのみ書き込まれる keychain:<service>/<scope>/<key> 参照をその場所に保持します。キーチェーンがない場合 (または DDM のためにロック解除されていないロックされたキーチェーンの場合)、シークレットは以前と同様に設定に保持されます。
ダウンロードのサーバーの場所 (#140) は、接続したアドレスの国であり、このコンピューターの mdm-geo のテーブルで検索されます (インターフェイス言語では countries.rs と表示されます)。リリース ジョブは、その月のデータからテーブルを再構築します (tools/geo/build.py --release)。
ブラウザ連携
page ──► extension ──native messaging──► mdm-nmhost ──ipc──► app
拡張機能は、ホストにどのファイル タイプを受け入れるかを尋ね、それらに対して各ダウンロードをチェックし、アプリがそれを受け入れた後にのみブラウザーのダウンロードをキャンセルします。そうでない場合、ブラウザーはそれを保持し、拡張機能はその理由を伝えます。
同じ応答には、オプション → 全般のキー (keys: page.js がクリックを保持するキー。リンクをブラウザーに任せるか、アプリに強制するかを決めます) と、表示する右クリック項目 (menu: 変更されると background.js がメニューを作り直します) も含まれます。動画ボタンを表示してよいかの応答には、ダウンロード パネルの設定 (panel: 動画やサウンド プレーヤーの上、最短の長さ、最初の隅) が含まれます。名前と既定値は mdm_ipc::capture のもので、アプリが保存する設定から読み取ります。拡張機能は、ブラウザーのウィンドウにフォーカスが戻ったとき (前回の問い合わせから数秒後)、ページが開始したとき (15 秒)、ダウンロードのとき (1 分) に、あらためて問い合わせます。
ツールバー ポップアップのダウンロード リスト (一時停止、再開、フォルダーを開く) とボタンの数字は、オートメーション API の list とアクションで、browser を付けてホスト経由で問い合わせます。アプリは、API のスイッチにかかわらずこれらに応答し、動画ボタンの画質メニューにも同様に応答します。ホストがそのためにアプリを起動することはありません。拡張機能が問い合わせるのは、ポップアップを開いているときか、ダウンロードの実行中だけです。
ホストは DDM 独自の拡張機能のみを提供します。その ID は mdm_ipc::extension (crates/ipc/src/extension.rs) の 1 か所にあります。展開されたコピーの ID (UNPACKED_ID、マニフェストの公開キーから)、Chrome ウェブストアの ID (STORE_ID、ストア独自のキーで署名されています。pack.ps1 はマニフェストのキーをストアのコピーから除外します)、Firefox アドオンの ID (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 を実行します。ループは、コマンド チャネルによって起動されるベア egui::Context でその tick (すべてのフレームで logic が実行するもの) を呼び出し、その ui は呼び出しません。コマンドはリモート コントロールが追加するのと同じように追加されます (ウィンドウなし)。Dockerfile と docker/ (Compose、Unraid のテンプレート) は、サーバー (server.md) でそれを実行します。
サーバーはアプリのTokioランタイム上で実行され、ローカル ネットワーク アドレスごとに1つのリスナーがあります。各リクエストはチェックされ(Host、Origin、トークン)、remote とマークされた mdm_ipc::Command(リクエスト行で設定できないフィールド)に変換され、コマンド ラインと同じチャネルを通じてアプリに渡されます。アプリは、自動化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 は、各言語のスタイル ガイド (i18n/style/) と用語集に従って、他のカタログに不足しているもの (行は #, machine とマークされています) を埋めます。人がレビューした行は決して置き換えられず、CI (reviewed_guard.py) は、その行を削除する変更を失敗させます。ウェブサイトには独自のカタログがあります (i18n/site/、tools/website/translate_site.py)。
画像
アプリのアイコンは図形から描画されます (tools/icon/dannex_logo.py。build_icon.py が 16 ~ 48 px のすべてのサイズを、整数ピクセルに合わせて手作業で配置して書き出します)。アイコンを表示する場所ではすべて、画面上のサイズに合う絵を使います (logo.rs)。Windows では、各ウィンドウのタイトル バーとタスク バーのアイコンを、そのディスプレイのスケールに合わせ (win32::crisp_icons。別のディスプレイに移してもそのまま保たれます)、トレイのアイコンはタスク バーのスケールに合わせます。表示 → DDM 通知領域アイコンでは、フルカラー (3D スタイル) か、タスク バーの色によるマークだけ (フラット スタイル: 暗いタスク バーでは白、明るいタスク バーでは暗い色。macOS ではテンプレート イメージ) を選べ、ダウンロード中は下端に細いバーが表示されます。
ヘルプ ページの画像 (docs/images/help/) は、1 つのリスト tools/shots/shots.toml から取得されます。tools/shots/make.py は、DDM 独自の /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、各リリースの準備時。GitHub では README 内の画像を丸くできないため、丸い写真は art/contributors/ にコミットされています) など、貢献者に感謝するすべての場所で使用されます。
テストとベンチマーク
cargo testmdm-labserverを対象に、接続が遅い場合や、切断・拒否される場合、範囲リクエストに対応していないサーバー、変更されるファイルなどの障害を注入して、単体テストとエンドツーエンドのダウンロードテストを実行します。tools/benchは公開されている速度比較を実行します。生データはdocs/bench/にあります。
ウィンドウのフレームは、推測ではなく実測します (crates/app/src/framestats.rs)。MDM_FRAME_STATS=1 は 1 秒ごとに、メイン ウィンドウの描画の回数、そのうち入力によるものの数、かかった時間 (メイン ウィンドウ、進行状況ウィンドウ、そのレイアウト)、それ以外を要求したコードの行をログに記録します。MDM_SYNTHETIC_LIST=10000 (作業用の MDM_DATA_DIR と組み合わせて) は、その数だけ架空の行を追加します。MDM_BENCH_SCROLL=10 は 10 秒間リストを自動でスクロールし、フレームの時間をログに記録します。アイドル中のウィンドウは、時計の分 (2 秒に 1 回) のほかはフレームを描画せず、リストは表示中の行だけを作ります。
無料、オープンソース、広告なし、試用期間なし。
Dannex Download Managerをダウンロード