agalwood / motrix

Get started

Taken from the repository's own files on 24 Oct 2026. RepoPilot has not run these commands.

Prerequisites

pnpm@12.15.0 from package.json

Commands

package.json

Task	Run	What it runs
start	`pnpm run start`	`node scripts/dev.mjs`
build	`pnpm run build`	`pnpm run build:builtin && pnpm run build:native-host && pnpm run build:finalize-fs && pnpm build:electron`
test	`pnpm run test`	`vitest run`
lint	`pnpm run lint`	`biome check .`

Install and use

README.md

npm install -g @motrix/cli    # Requires Node.js 22 or later

motrix add https://example.com/file.iso --save-dir ~/Downloads
motrix list                   # List downloads
motrix watch --stats          # Stream live progress as NDJSON
motrix pair --name my-nas     # Pair with a remote or headless instance

Open README.md

Developing

CONTRIBUTING.md

Development requires Git, Node.js 22 or later, and the pnpm version declared in the packageManager field of package.json.

Fork the repository if you do not have write access, then clone your fork and install the dependencies:

git clone https://github.com/<your-account>/Motrix.git
cd Motrix
pnpm install
pnpm start

By default, pnpm start uses a separate user-data profile next to the regular Motrix profile (normally Motrix-dev), so development does not modify the installed application's data. To select another directory, set MOTRIX_USER_DATA to its absolute path before running pnpm start.

Create your development branch from the latest main and target main with your pull request. The legacy master branch only preserves the v1 codebase and is frozen; do not submit new changes to it.

Branch names use <type>/<snake_case_topic>_<YYYYMMDD>. You may place an issue number before the topic when one is available, for example fix/1970_conduct_links_20260826.

Open CONTRIBUTING.md

Get started

Taken from the repository's own files on 24 Oct 2026. RepoPilot has not run these commands.

Prerequisites

pnpm@12.15.0 from package.json

Commands

package.json

Task	Run	What it runs
start	`pnpm run start`	`node scripts/dev.mjs`
build	`pnpm run build`	`pnpm run build:builtin && pnpm run build:native-host && pnpm run build:finalize-fs && pnpm build:electron`
test	`pnpm run test`	`vitest run`
lint	`pnpm run lint`	`biome check .`

Install and use

README.md

npm install -g @motrix/cli    # Requires Node.js 22 or later

motrix add https://example.com/file.iso --save-dir ~/Downloads
motrix list                   # List downloads
motrix watch --stats          # Stream live progress as NDJSON
motrix pair --name my-nas     # Pair with a remote or headless instance

Open README.md

Developing

CONTRIBUTING.md

Development requires Git, Node.js 22 or later, and the pnpm version declared in the packageManager field of package.json.

Fork the repository if you do not have write access, then clone your fork and install the dependencies:

git clone https://github.com/<your-account>/Motrix.git
cd Motrix
pnpm install
pnpm start

Branch names use <type>/<snake_case_topic>_<YYYYMMDD>. You may place an issue number before the topic when one is available, for example fix/1970_conduct_links_20260826.

Open CONTRIBUTING.md

Development requires Git, Node.js 22 or later, and the pnpm version declared in the packageManager field of package.json.

Fork the repository if you do not have write access, then clone your fork and install the dependencies:

git clone https://github.com/<your-account>/Motrix.git
cd Motrix
pnpm install
pnpm start

Branch names use <type>/<snake_case_topic>_<YYYYMMDD>. You may place an issue number before the topic when one is available, for example fix/1970_conduct_links_20260826.