agalwood/Motrix

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/agalwood/Motrix.svg?style=card)](https://bestofgithub.dev/repo/agalwood/Motrix)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/agalwood/Motrix.svg)](https://bestofgithub.dev/repo/agalwood/Motrix)

Loading README…

Project	Distribution	What it does
`@motrix/mdxp`	npm package	Defines the shared JSON-RPC 2.0 wire schemas and Zod types for MDXP, with helpers for bidirectional connections
`@motrix/cli`	npm package	Provides the `motrix` command, automatically discovers a local desktop app, and pairs with remote instances
Motrix Extension	Browser extension	Intercepts downloads in Chrome, Edge, and Firefox (Manifest V3), hands them off to Motrix, and pairs securely with the desktop app over native messaging
Motrix Plugin SDK	Four npm packages	Includes `@motrix/plugin-manifest-schema`, `@motrix/plugin-api`, `@motrix/plugin-cli`, and `create-motrix-plugin` for developing, testing, and packaging plugins
Builtin Plugins	Signed `.moext` packages	Includes three official plugins: Filename Template for renaming files from a template before they are saved, Page Scraper for extracting direct file links from HTML pages, and URL Resolver as the foundation for site-specific media resolution
Plugin Registry	Public JSON feed	Publishes plugin listings and install metadata at `dl.motrix.app/registry/plugins.json` for both the website and the in-app marketplace

Platform	Architectures	Packages / channel	Recommendation
macOS 13+	`arm64` (Apple Silicon), `x64` (Intel)	`.dmg` / `.zip`	Use the `.dmg` matching your Mac; choose `x64` only for an Intel-based Mac
Windows 10+	`x64`, `arm64`	`.exe` (NSIS installer) / `.zip`	Use the `.exe` installer for a normal installation or `.zip` for a manually extracted copy
Linux	`x64`, `arm64`	`.AppImage` / `.deb` / `.rpm`	Use the portable `.AppImage` on any distribution, `.deb` on Debian or Ubuntu, or `.rpm` on Fedora or openSUSE
Linux (Snap Store)	`amd64`, `arm64`	`latest/stable`	Install the strictly confined package with `sudo snap install motrix` after stable promotion
Linux (Flatpak)	`x86_64`, `aarch64`	`.flatpak`	Install a versioned bundle from a release that includes it; see the Flatpak guide
Arch Linux / Omarchy	`x64`, `arm64`	`.pacman`	Install the native Arch package with `sudo pacman -U ./Motrix-<version>-<arch>.pacman`; see the Arch installation guide

Area	Stack
Desktop shell	Electron 44
UI	React 19 + Tailwind CSS 4 + shadcn/ui
Language	TypeScript in strict mode
Build system	Vite 8 with separate main, preload, worker, and renderer targets
Validation	Zod 4 for settings, IPC payloads, and wire schemas
Download engine	A Motrix-maintained fork of aria2, bundled with the app
Persistence	better-sqlite3 for download session storage and recovery
Plugin sandbox	quickjs-emscripten
Server runtime	Node.js + Fastify + WebSocket
Internationalization	i18next + react-i18next
Quality tooling	Biome, Vitest, and Playwright

Motrix