1. 主页
  2. 帮助
  3. 开始使用

开始使用

MDM runs on Windows 10 and Windows 11 (x64, ARM64 and 32-bit), and on 64-bit Linux (x86-64 and ARM64): see On Linux. Builds for macOS are new and still experimental: see On a Mac.

选择下载文件

所有版本都在发布页面上。Windows 有三个文件:

文件 说明
MisterDownloadManager-<version>-setup.exe 安装程序。除非您有特殊原因,否则请选择此项。它可以设置浏览器集成,并使用 MDM 打开 .torrent 文件和磁力链接。
MisterDownloadManager-<version>-portable.zip 便携版。下载列表和设置保留在程序旁边的 data 文件夹中,并且不会写入注册表。浏览器集成需要安装程序。请参阅便携模式。
MisterDownloadManager-<version>-x64.zip 不带安装程序的程序。它将数据保存在 %APPDATA%\mattdownloadmanager 中,就像已安装的版本一样。

These three are for 64-bit Windows on an Intel or AMD processor (x64), the usual PC. From the version after 0.5.2, each comes for two more kinds of PC too, with the processor in its name:

Files For
...-setup-arm64.exe, ...-portable-arm64.zip, ...-arm64.zip Windows on ARM (PCs with a Snapdragon or another ARM processor). On Windows 11 the x64 files run there too, translated by Windows, more slowly. The ARM64 setup installed over the x64 one replaces it; your list and settings stay, as they are kept in your profile, not with the program.
...-setup-x86.exe, ...-portable-x86.zip, ...-x86.zip 32-bit Windows 10. Not sure which you have? Settings → System → About → System type says it. MDM can't download ffmpeg for you there (none is built for 32-bit Windows that MDM can check): to get the best video qualities, choose an ffmpeg of your own in Helpers... (Video).

Help → Check for updates updates each copy to the files for its own processor.

通过 WinGet 安装

MDM 也可在 Windows 的包管理器 WinGet 中获取。在终端中,第一行安装 MDM,第二行将其更新到最新版本:

winget install AhmedNefzaoui.MisterDownloadManager
winget upgrade AhmedNefzaoui.MisterDownloadManager

WinGet 会下载安装程序并安装 MDM,无需回答安装程序的问题。

在 Linux 上

MDM runs on 64-bit Linux with a desktop session. It is tested on Ubuntu 24.04, Debian 12 and Fedora, with GNOME, KDE Plasma, Xfce and Cinnamon, on X11 and in Wayland sessions. Pick one of these files (up to version 0.2.4, their names end in -experimental, as in ...-linux-x86_64-experimental.deb). From the version after 0.5.2, each also comes for 64-bit ARM computers, with arm64 in place of x86_64 (...-linux-arm64.deb); they are built and tested on GitHub's ARM machines. On ARM, MDM doesn't download gallery-dl itself (its author builds none for it): install it with your system's packages or pip.

文件 说明
...-linux-x86_64.deb 适用于 Ubuntu、Debian、Mint 和 Pop!_OS:sudo apt install ./<file>.deb。它包含了 MDM 所需的库。
...-linux-x86_64.rpm 适用于 Fedora、openSUSE 和 RHEL:sudo dnf install ./<file>.rpm。它包含了 MDM 所需的库。
...-linux-x86_64.AppImage 可在大多数发行版上运行:使其可执行(chmod +x)并运行。它会原地更新(帮助 → 检查更新)。
...-linux-x86_64.tar.gz 适用于任何发行版的纯程序。
MDM 在 Ubuntu 24.04 GNOME 桌面上的主窗口:类别和下载列表,每个下载任务都带有桌面为其类型显示的图标MDM 在 Ubuntu 24.04 GNOME 桌面上的主窗口:类别和下载列表,每个下载任务都带有桌面为其类型显示的图标
MDM 在 Ubuntu 的 GNOME 桌面上运行,使用桌面自带的文件图标。

浏览器集成由 MDM 每次启动时自行设置(会找到当时安装的浏览器);按照浏览器集成中的说明添加扩展。作为 Snap(Ubuntu 的)安装的 Firefox 在您允许后即可连接 MDM;其他 Snap 和 Flatpak 浏览器无法连接(请参阅Flatpak 和 Snap 浏览器)。托盘图标、深色模式支持和开机启动功能在 GNOME(Ubuntu 的)、KDE Plasma、Xfce 和 Cinnamon 上均可使用。

在 Linux 上提供浏览器扩展的窗口:Google Chrome 和 Mozilla Firefox,每个都有“添加扩展”按钮
MDM 会找到已安装的浏览器,并为每个浏览器提供其扩展。

In a Wayland session the windows go through XWayland or Wayland (below). Not there yet on Linux: screen readers (Orca) don't read MDM's windows; browsers installed as a Flatpak can't reach MDM (Firefox from Flathub may, through the desktop as the Snap does, but that isn't checked yet); and View → Draw with → Vulkan is a choice, OpenGL stays the default.

In a Wayland session, MDM chooses its windows' system as it starts, the same way however it was started (its menu entry, the browser's helper, the session's autostart). Its windows run through XWayland where X11 programs look right: only X11 lets MDM open its menus and drop-down lists right under what you clicked (on Wayland they open where the compositor puts new windows, often the middle of the screen) and hide its window in the notification area. That is GNOME and KDE Plasma, which tell X11 programs the screen's scale, and any desktop whose screens aren't scaled. On a scaled screen where nothing tells X11 programs the scale (Hyprland, labwc, sway and other wlroots compositors), the compositor would scale MDM's windows up, blurry, so MDM uses Wayland's own windows there. View → Window system picks X11 (XWayland) or Wayland instead, from the next start, for every way MDM starts (Automatic goes back to MDM's choice); MDM_WAYLAND=1 or MDM_WAYLAND=0 decides for one start. If the system lacks a library X11 windows need (such as libxkbcommon-x11, which the .deb and .rpm bring but the AppImage and the tar.gz can't), MDM opens on Wayland instead; with no window system it can use, it names what's missing and the command that installs it.

窗口是本帮助中描述的那些,带有桌面字体、文件图标和标题栏:

  • Linux 上的“添加 URL”窗口,带有其地址框
    添加 URL。
  • Linux 上下载的进度窗口:其速度、剩余时间和连接数
    下载进度。
  • Linux 上的“添加种子”窗口,带有种子的文件列表
    添加种子。
  • Linux 上的“计划程序”
    计划程序。
  • Linux 上“选项”的“连接”页面
    选项。

在其他已测试的桌面上:

  • KDE Plasma 上的 MDM 主窗口
    KDE Plasma。
  • Cinnamon 上的 MDM 主窗口
    Cinnamon。
  • Xfce 上的 MDM 主窗口
    Xfce。

在 Linux 上卸载

sudo apt remove mattdownloadmanager(或 sudo dnf remove mattdownloadmanager)会删除程序,以及告诉浏览器 MDM 助手位置的小文件:.deb 和 .rpm 为所有用户(在 /etc 和 /usr/lib 中)安装这些文件,支持 Chrome、Chromium、Edge、Brave、Vivaldi、Helium 和 Firefox(也包括 Snap),因此 MDM 不会将它们写入您的主文件夹。对于 AppImage 或 tar.gz,请删除文件或文件夹。

MDM 在您的主文件夹中保留的内容会像任何软件包一样保留:您的列表和设置(~/.local/share/mattdownloadmanager)、AppImage 和 tar.gz 的浏览器文件,以及那些只从此处读取它们的浏览器(Opera、Helium、Thorium 和 Firefox 的分支:Zen、LibreWolf、Floorp、Waterfox)。软件包无法移除这些文件:它从不触及主文件夹。没有 MDM,它们将无处可去,因此扩展会显示无法连接 MDM。要一并移除它们,请在卸载之前,以每个使用过 MDM 的用户身份运行以下命令:

mattdownloadmanager-nmhost --unregister

(来自 AppImage:~/.local/share/mattdownloadmanager/browser-host/mattdownloadmanager-nmhost --unregister。)已经卸载了?这会移除相同的文件:

find ~/.mozilla ~/.librewolf ~/.config -name com.mattdownloadmanager.host.json -delete 2>/dev/null

在 Mac 上

macOS 版本是新推出的,仍在实验阶段:我们自己尚未在 Mac 上试用过,因此您将是首批用户之一。请告诉我们您的体验,无论是好是坏。

文件 说明
...-macos-arm64-experimental.dmg For a Mac with Apple Silicon (M1 or later: Apple menu → About This Mac shows a Chip). Open it and drag Matt Download Manager to Applications. macOS asks before its first start, because the app isn't notarized by Apple: right-click it and choose Open (on macOS 15 and later: System Settings → Privacy & Security → Open Anyway).
...-macos-x86_64-experimental.dmg 同样,适用于配备 Intel 处理器(关于本机显示 处理器)的 Mac。

浏览器集成由 MDM 每次启动时自行设置(会找到当时安装的浏览器);按照浏览器集成中的说明添加扩展。

通过安装程序安装

  1. 运行 MisterDownloadManager-<version>-setup.exe。
  2. 选择语言。Windows 的显示语言已选中。安装程序提供 MDM 拥有的所有语言,MDM 将以您选择的语言启动。
  3. 选择是仅为您安装还是为计算机上的所有人安装。仅为您安装不需要管理员权限,并会安装到 %LOCALAPPDATA%\Programs\Matt Download Manager。为所有人安装会安装到 Program Files。
  4. Pick what the setup should do: - Set up browser integration (Chrome, Edge, Brave, Firefox) - Open .torrent files and magnet links with Matt Download Manager - Start Matt Download Manager when Windows starts - Create a desktop shortcut (off unless you tick it)
  5. 点击安装,然后点击完成以启动 MDM。

如果 MDM 正在运行,安装程序会先要求其保存并关闭。要更新,请使用帮助 → 检查更新 → 立即更新,或运行新版本的安装程序(或使用 WinGet 更新);您的下载列表和设置将保留不变。

浏览器集成在每个浏览器中都需要多一步:添加扩展。在 Firefox 中,点击 addons.mozilla.org 上的页面中的添加到 Firefox;在 Chrome、Edge、Brave、Opera 和 Vivaldi 中,点击 Chrome 网上应用店中的页面中的添加到 Chrome。浏览器集成会展示具体操作。

卸载

从 Windows 设置 → 应用中卸载 MDM。卸载程序会询问是否也删除您的下载列表和设置。您的下载文件永远不会被触及。

使用 zip 副本

  1. 将文件解压到您有写入权限的文件夹中(不要直接解压到 Program Files)。
  2. 运行 mattdownloadmanager.exe。

zip 文件包含与安装程序相同的程序:应用程序、mattdownloadmanager-cli.exe(用于从命令行下载;请参阅命令行和自动化)以及 extension 文件夹。

首次启动和语言

  • 通过安装程序安装: MDM 以您在安装程序中选择的语言启动。
  • 其他情况:MDM 会显示语言列表,每种语言都标有国旗和该语言的名称。选择您的语言。

您可以随时在视图 → 语言中更改语言。更多信息请参阅语言。

首次启动时的语言列表:每种语言都带有其旗帜、其本国名称和英文名称首次启动时的语言列表:每种语言都带有其旗帜、其本国名称和英文名称
选择您的语言。之后可通过“视图 → 语言”更改。

视频辅助工具

接下来,MDM 会提供 2 个免费的视频辅助工具:yt-dlp用于查找网页上的视频,ffmpeg用于合并视频画面和声音。点击是,下载它们(推荐),这两个工具就会在后台下载,约 100 MB,只需下载一次。点击暂不可稍后再下载:首次需要时,视频窗口会提供下载选项。更多信息请参阅视频。

MDM 在首次启动时提供 yt-dlp 和 ffmpeg,并带有“是,下载它们(推荐)”和“暂不”选项MDM 在首次启动时提供 yt-dlp 和 ffmpeg,并带有“是,下载它们(推荐)”和“暂不”选项
点击“是”会在后台下载这两个辅助工具,只需下载一次。

主窗口

主窗口:菜单栏、工具栏、左侧的类别和右侧的下载列表主窗口:菜单栏、工具栏、左侧的类别和右侧的下载列表
1 菜单栏,2 工具栏,3 类别,4 下载列表。

从上到下:

  • 菜单栏。
  • 任务 — 添加下载、种子、磁力链接、批量下载和网页视频;种子设置;链接抓取器;RSS 源;显示拖放目标;导入和导出列表;退出。
  • 文件 — 对选中的下载执行以下操作:停止下载、删除、立即下载、重新下载。
  • 下载 — 暂停所有、停止所有、删除所有已完成、查找、计划程序、队列、速度限制器和选项。
  • 视图 — 显示或隐藏类别,排序列表(整理文件),深色模式支持,始终为深色,主题,界面大小(所有窗口放大,100% 到 200%;也可用 Ctrl +、Ctrl − 和 Ctrl 0),文本(Windows:平滑或经典字体),绘制方式(Windows 上为 OpenGL 或 Direct3D,Linux 上为 Vulkan,macOS 上为 Metal)和 语言。
  • 帮助 — 帮助页面和教程(在网站上,如果支持您的语言则显示您的语言),键盘快捷方式,报告问题,检查更新,关于,告诉朋友 和 支持 MDM(其创建者的 GitHub 赞助者页面:可选,MDM 中没有任何更改)。
  • 工具栏。添加 URL、添加 Torrent、恢复、停止、停止所有、删除、删除已完成、选项、计划程序、启动队列、停止队列。点击添加 Torrent、启动队列和停止队列旁边的小箭头可打开更多选项。
  • 类别(左侧)。选择列表显示的内容:所有下载、未完成、已完成和队列,每个项目下还有相应的类别。拖动窗格与列表之间的分隔线可加宽窗格。
  • 下载列表(右侧)。每行一个下载。请参阅下载列表。

深色模式

MDM 会跟随系统设置:当 Windows(或 Linux 和 macOS 上桌面环境的浅色/深色偏好设置)设为深色模式时,MDM 也会使用深色模式。要让 MDM 不受系统设置影响,始终保持浅色,请关闭视图 → 深色模式支持。要让 MDM 不受系统设置影响,始终保持深色(例如,桌面环境未报告偏好设置时),请开启视图 → 始终为深色。

“视图”菜单已打开,带有“深色模式支持”和“始终为深色”选项“视图”菜单已打开,带有“深色模式支持”和“始终为深色”选项
1 深色模式支持会跟随系统设置;2 始终为深色会让 MDM 保持深色模式。

主题

视图 → 主题可立即更改 MDM 的外观,同时保留原有布局:

  • 经典:MDM 自带的外观,默认主题。
  • 本机:使用系统颜色。Windows 的强调色(设置 → 个性化 → 颜色),以及开启时的高对比度主题;Linux 桌面环境的强调色和高对比度设置(GNOME 47 及更高版本、KDE Plasma);macOS 的强调色。更改这些设置时,MDM 也会随之更新。
  • 高对比度:黑白配色、鲜明的强调色、所有边缘均清晰显示,文本对比度至少为 7:1。
  • 现代:Windows 8 的扁平外观:方形边角,扁平按钮和方框,带有居中标题的彩色标题栏(在 Windows 上,由 MDM 绘制),以及单色图标(Microsoft 的 Fluent UI System Icons)。
  • Adwaita:GNOME 的外观:圆角、扁平的灰色按钮、圆形的焦点环、GNOME 的复选框、带有粗体标题和圆形按钮的标题栏(在 Windows 上,由 MDM 绘制),以及 GNOME 的 Adwaita 图标,文件和类别为彩色,工具栏为单色。
  • Breeze:KDE Plasma 的外观:圆角、在指针下方或聚焦时带有强调色边缘的按钮和框、KDE 的复选框和焦点框、KDE 的标题栏(标题居中,圆形按钮,在 Windows 上,由 MDM 绘制),以及 KDE 的 Breeze 图标。
  • Luna:Windows XP 的外观:按钮从白色渐变,指针悬停时发出橙色光晕,绿色对勾,方形文本框,绿色块状进度条,深蓝色标题栏,标题加粗(在 Windows 上,由 MDM 绘制),以及为 MDM 绘制的彩色图标。
  • Aero:Windows 7 的外观:光泽按钮,指针悬停时变为浅蓝色,低调的复选框,光泽绿色进度条,玻璃质感标题栏,标题带有柔和光晕(在 Windows 上),以及为 MDM 绘制的光泽图标。
  • Aqua:Mac OS X 的外观:两端圆润的凝胶按钮(默认蓝色),光泽复选框,蓝色焦点环,蓝色凝胶进度条,灰色标题栏,带有小圆形按钮(在 Windows 上),以及为 MDM 绘制的图标。
  • 翡翠:白色画布,搭配近乎黑色的墨水和一系列中性灰色调以构建结构,翡翠色填充总是承载近乎黑色的文本而非白色,所有控件均采用 6 点圆角,以及现代风格的单色图标。
视图 → 主题 打开:经典、原生、高对比度、现代、Adwaita、Breeze、Luna、Aero、Aqua 和翡翠,以及打开主题文件夹视图 → 主题 打开:经典、原生、高对比度、现代、Adwaita、Breeze、Luna、Aero、Aqua 和翡翠,以及打开主题文件夹
视图 → 主题会立即切换,并保持布局不变。
  • 主窗口的工具栏和类别采用经典主题主窗口的工具栏和类别采用经典主题
    经典
  • 主窗口的工具栏和类别采用高对比度主题主窗口的工具栏和类别采用高对比度主题
    高对比度
  • 主窗口的工具栏和类别采用 Adwaita 主题主窗口的工具栏和类别采用 Adwaita 主题
    Adwaita
  • 主窗口的工具栏和类别采用 Breeze 主题主窗口的工具栏和类别采用 Breeze 主题
    Breeze

每个主题都有亮色和深色模式:深色模式支持 和 始终为深色 像以前一样在它们之间进行选择。您放入主题文件夹(视图 → 主题 → 打开主题文件夹)的主题文件也会在此处列出,Base16 和 pywal 配色方案也是如此(视图 → 主题 → 添加主题文件…;pywal 运行时遵循 wal):主题 说明了该文件夹的位置、主题文件包含的内容(inherits、颜色、大小、控件形状、图标)、配色方案的颜色如何使用,以及如何制作和分享主题文件。

托盘图标

关闭主窗口不会退出 MDM。它会隐藏在通知区域,下载、队列和计划会继续运行。要使关闭窗口即退出(之后便可删除便携版副本的文件夹),请取消勾选选项 → 常规 → 关闭窗口时保持运行。如果通知区域或“^ 隐藏图标”后面都没有 MDM 图标,则窗口会最小化到任务栏,这样下载仍会继续,并且可以找回窗口。点击“^”后面的图标可以恢复窗口,再次启动 MDM 也能恢复。

在 Linux 上,这需要一个托盘,大多数桌面环境都具备(KDE Plasma、Xfce、Cinnamon、Ubuntu 的 GNOME 或带有 AppIndicator 扩展的 GNOME、waybar 的托盘)。在没有托盘的桌面环境(某些平铺式窗口管理器)中,关闭窗口会退出 MDM,因为无法将其恢复。

MDM's icon in the top bar of Ubuntu's GNOME, its menu open: Open Matt Download Manager, Add new download, Add batch download, Downloads in progress, Speed Limiter, Scheduler, the main queue, Options and Exit
Ubuntu GNOME 上的托盘图标菜单。
  • 点击托盘图标可恢复窗口。
  • 右键单击它可选择添加新下载、添加批量下载、正在进行的下载、速度限制器、计划程序、主下载队列、选项和退出。
  • 正在进行的下载列出正在运行的下载。选择一个可查看其进度窗口。

当选项 → 常规中的最小化到通知区域开启时,“最小化”也会将主窗口隐藏到通知区域。此选项默认开启;如果通知区域没有图标,“最小化”会将窗口发送到任务栏。

下载进度窗口也可以通过其“最小化”按钮或“隐藏到通知区域”按钮(一个短横线,带一个指向角落的箭头)隐藏到那里。

在 Windows 上,该按钮位于窗口标题栏的“最小化”按钮左侧,以及标题栏菜单 (Alt+Space) 中。在 Linux 和 macOS 上,它位于标签行末尾。

要恢复窗口,请在正在进行的下载中选择它,或双击列表中的下载项。

要退出,请选择任务 → 退出或托盘菜单中的退出。

MDM 存储数据的位置

下载列表和设置保存在 %APPDATA%\mattdownloadmanager (downloads.json) 中;在 Linux 上保存在 ~/.local/share/mattdownloadmanager 中,在 Mac 上保存在 ~/Library/Application Support/mattdownloadmanager 中。便携版则将其保存在 data 文件夹中。下载的文件会保存到您的 下载 文件夹,并按类别分类到子文件夹中;您可以在选项 → 保存到 中更改此设置。

下一步

免费、开源、无广告、无试用版。

下载 Matt Download Manager