How agalwood/motrix works
Motrix is a desktop and headless download manager. The main workflow is submitting a URL, torrent, or magnet through the UI or a client; the core creates and manages a task, the aria2 engine transfers it, and session state supports recovery. Separate capabilities include browser/remote bridging, media capture, plugins, tracker and NAT management, and notifications. The README documents these product branches; sampled source confirms selected engine, torrent, media, and notification details, so uncertain internal wiring is omitted.
Main entry points: task-manager.ts Task Manager · create-task-handler.ts Task Creation · engine-supervisor.ts Engine Supervisor · bridge-receiver.ts Bridge Receiver
Components 23
User Interfaces
- Desktop UI
src/renderer/components/add-task/add-task-form.tsx - Web UI
src/renderer - Preload API
src/preload/api.ts - Engine Diagnostics
src/renderer/features/engine-diagnostics/engine-diagnostics-dialog.tsx
Download Runtime
- Task Creation
src/core/task/create-task-handler.ts - Task Manager
src/core/task/task-manager.ts - Engine Supervisor
src/core/engine/engine-supervisor.ts - aria2 Engine
- Torrent Layout
src/core/task/bt-storage-layout.ts - Session Database
src/core/session/motrix-database.ts - Download Finalization
src/core/task/actions/finalize-task.ts - Engine Status Types
src/shared/types/engine.ts
Client Integrations
- MDXP Bridge
src/core/bridge/web-socket-bridge-server.ts - Bridge Receiver
src/core/bridge-receiver/bridge-receiver.ts - Browser Extension
- CLI / Remote Client
- Media Pipelines
src/core/bridge-receiver/pipelines/hls-dash-pipeline.ts
Extensibility
- Plugin Runtime
src/core/plugin/runtime/plugin-hook-runtime.ts - Plugin Installer
src/core/plugin/install/plugin-installer.ts
Supporting Services
- Tracker Management
src/core/tracker/tracker-manager.ts - NAT Mapping
src/main/nat/nat-manager-factory.ts - Notifications
src/core/notifications/engine-failure-subscriber.ts
Other components
- User
Connections 23
- User → Desktop UI: submits download
- Desktop UI → Preload API: invokes app API
- Preload API → Task Creation: forwards requests
- Task Creation → Task Manager: creates tasks
- Task Manager → Engine Supervisor: manages transfers
- Engine Supervisor → aria2 Engine: controls engine
- Task Manager → Session Database: persists sessions
- Task Manager → Torrent Layout: validates torrent layout
- Task Manager → Download Finalization: finalizes completed tasks
- Browser Extension → MDXP Bridge: hands off downloads
- CLI / Remote Client → MDXP Bridge: sends MDXP requests
- MDXP Bridge → Bridge Receiver: dispatches requests
- Bridge Receiver → Task Creation: submits tasks
- Bridge Receiver → Media Pipelines: routes media jobs
- Media Pipelines → Task Manager: coordinates media tasks
- Plugin Installer → Plugin Runtime: installs plugins
- Plugin Runtime → Task Creation: hooks task lifecycle
- Engine Supervisor → Notifications: emits failures
- Notifications → Session Database: records notification ledger
- Engine Diagnostics → Engine Status Types: uses status contract
- Tracker Management → aria2 Engine: manages tracker list
- NAT Mapping → aria2 Engine: maps peer ports
- Web UI → Task Creation: submits downloads