agalwood /Motrix

A full-featured download manager.

★ 58,329⑂ 5,155👁 484⑃ 697● 1,642▤ 67
TypeScriptNOASSERTIONCreated 2018-12-18motrix.app
下载:v2.4.2v2.4.2 ↓2.4.22026-11-15
+63
日增长
+309
周增长
58,329
stars
5,155
forks
484
watchers
697
prs
1,642
issues
67
releases

README

Motrix
  简洁易用、功能丰富的现代下载管理器


 !Build/release !Total Downloads

English | 简体中文

 简介

Motrix 是一款界面简洁、功能丰富的桌面下载管理器,可处理 HTTP、FTP、BitTorrent 和磁力链接(Magnet)等多种下载任务。

Motrix Turbo 是 Motrix 的 v2 版本。它保留了 v1 简洁易用的特点,并使用 Electron、React 和 TypeScript 重新开发。下载内核与界面相互独立;浏览器扩展和命令行工具通过开放协议 MDXP(Motrix Download eXchange Protocol,采用 JSON-RPC 2.0)与应用通信,插件则在独立的沙箱中运行。

同一套内核既可用于桌面应用,也可作为 Headless server 运行:

- 桌面应用:可在 macOS、Windows 和 Linux 上运行;
- Headless server:无需桌面环境,可直接使用 Node.js 运行或通过 Docker 部署,并提供 Web 界面,适合安装在 NAS 和家庭服务器上。

 Motrix 2.4.2

删除任务后,Motrix 会取消该任务尚未完成的文件整理恢复,避免重启后再次处理已删除任务。
本版还更新 Electron、SQLite 和 WebSocket 等依赖。
从 GitHub Releases 下载 v2.4.2,
并阅读完整发布说明。

升级前请备份现有 Motrix 配置和下载文件。捆绑引擎会将 SQLite 数据库升级至
schema 6,并保留升级前备份;旧引擎无法打开 schema 6,如需降级必须保留该备份。
桌面端迁移助手会将选中的 v1 任务导入为暂停记录,并保留原文件;恢复下载需要
单独明确操作。Windows 原位激活 BitTorrent 任务要求使用受支持的本地 NTFS 卷,
并明确授权。支持的磁盘类型、文件权限和恢复方式见
迁移指南。请保留原始 v1 配置。

 应用截图

 仪表盘


  
  
  


 下载任务


  
  
  


 设置


  
  
  


 ✨ 主要功能

- 🕹 简洁直观的图形界面,支持深色模式
- 🦄 支持 BT 和磁力链接任务,可按需选择种子中的文件
- 📡 内置 Tracker 列表,可自动更新并检查可用性
- 🔌 支持 UPnP 和 NAT-PMP 端口映射
- 🚥 可限制上传和下载速度,并在多档限速模式之间切换
- 💾 下载会话保存在 SQLite 中,重启应用后可自动恢复任务
- 📊 Dashboard 支持自定义布局,可展示传输统计、实时活动和任务磁贴
- 🔔 下载完成时发送系统通知,应用内也可集中查看通知
- 🧩 插件采用 QuickJS 沙箱隔离和细粒度能力授权,并可直接从应用内插件市场安装
- 🌐 Chrome、Edge 和 Firefox 上的 Motrix Extension 可一键将浏览器下载任务交给 Motrix
- ⌨️ 官方命令行客户端 @motrix/cli 既适合日常操作,也可供 AI agent 调用
- 🐳 Headless server 可通过 Docker 部署,远程 CLI 和 agent 可使用 device-code 安全配对
- 🎬 URL Resolver 插件可解析站点媒体页面,并可扩展对更多站点的支持
- 🤖 可驻留系统托盘,并支持开机自启动
- 🌍 界面支持简体中文和英语,后续将加入更多语言
- 🔗 注册 motrix:// 和 magnet: 协议处理程序,并关联 .torrent 文件

 🧩 周边生态

除了桌面应用,Motrix 还提供协议库、命令行客户端、浏览器扩展和插件开发工具。这些项目与应用本身共同组成 Motrix 生态:

| 项目 | 形式 | 说明 |
|------|------|------|
| @motrix/mdxp | npm 包 | 集中定义 MDXP 的 JSON-RPC 2.0 wire schema 和 Zod 类型,并提供双向连接工具,让通信两端使用同一套协议 |
| @motrix/cli | npm 包 | 命令行客户端,可执行命令为 motrix。它能自动发现并控制本地桌面应用,也能与远程实例配对 |
| Motrix Extension | 浏览器扩展 | 面向 Chrome、Edge 和 Firefox 的 MV3 扩展,可接管浏览器下载任务,并通过 native messaging 与桌面应用安全配对 |
| Motrix Plugin SDK | 4 个 npm 包 | 包括 @motrix/plugin-manifest-schema、@motrix/plugin-api、@motrix/plugin-cli 和 create-motrix-plugin,提供插件开发、调试和打包所需的工具 |
| Builtin Plugins | 已签名的 .moext | 官方提供三个内置插件:Filename Template(保存文件时按模板自动重命名)、Page Scraper(从 HTML 页面提取实际文件链接)和 URL Resolver(为站点媒体解析提供基础能力) |
| Plugin Registry | 公共数据源 | 维护插件列表和安装信息,并生成 dl.motrix.app/registry/plugins.json,供官网插件目录和应用内插件市场使用 |

 CLI 快速上手

bash
npm install -g @motrix/cli     需要 Node.js = 22

motrix add https://example.com/file.iso --save-dir ~/Downloads
motrix list                    查看任务列表
motrix watch --stats           以 NDJSON 流式输出实时进度
motrix pair --name my-nas      通过 device-code 配对远程或 headless 实例


 编写插件

Motrix Plugin SDK 提供 TypeScript API、manifest schema、项目脚手架和 CLI,覆盖完整的插件开发流程:

bash
pnpm create motrix-plugin my-plugin
cd my-plugin && pnpm install
pnpm dev                          监听构建,并启动 Motrix 加载插件
pnpm exec motrix-plugin validate  校验 motrix-plugin.json
pnpm run pack                     生成 dist/-.moext
pnpm exec motrix-plugin lint      检查打包产物


默认脚手架会创建一个使用 befo

Top issues

Discussions

Latest release

v2.4.2 v2.4.2 2026-11-15
Motrix 2.4.2

English | 简体中文

 Changes since 2.4.1

- Cancel unfinished file finalization recovery in the same database transaction that deletes a task. Retire orphaned recovery records from older versions at startup so deleted tasks are not processed again.
- Update the desktop runtime to Electron 45.3.2 and the database dependency to better-sqlite3 13.2.0.
- Update ws to 8.23.0, fixing memory exhaustion caused by a malicious peer flooding Ping frames.
- Refresh translation, form, proxy and icon dependencies, together with build, test and offline packaging tools.

 Upgrade compatibility

Back

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON