# Motrix v2.0.0-beta.22

- Product: Motrix (https://whatsnew.fyi/product/motrix)
- Vendor: agalwood
- Date: 2026-08-22
- Version: v2.0.0-beta.22
- Original notes: https://github.com/agalwood/Motrix/releases/tag/v2.0.0-beta.22
- Permalink: https://whatsnew.fyi/product/motrix/releases/v2.0.0-beta.22
- Labels: Pre-release

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **changed** — Update bundled download engine to aria2 1.37.0-motrix.10
- **added** — Check aria2c version before starting engine to verify Motrix fork with SQLite persistence feature
- **changed** — Limit max-connection-per-server and split to 16 when non-Motrix aria2 executable is detected
- **fixed** — Handle aria2 error code 28 defensively by retrying URI creation with compatible connection values
- **fixed** — Persist engine-adopted parent tasks before task inspectors can save child files or peers to prevent SQLite foreign-key race
- **added** — Add Lightweight mode to release hidden main-window renderer while downloads continue
- **fixed** — Read clipboard only when New Task window opens to prevent editing form from being overwritten by clipboard changes
- **fixed** — Restore compact window height after collapsing Advanced options in New Task window

#### Motrix 2.0.0-beta.22

English | [简体中文](https://github.com/agalwood/Motrix/blob/v2.0.0-beta.22/docs/release-notes/2.0.0-beta.22.zh-CN.md)

Motrix 2.0.0-beta.22 updates the bundled download engine to aria2
`1.37.0-motrix.10`, makes custom upstream aria2 replacements safe, fixes an
engine task-adoption race, adds a lower-memory desktop mode, and polishes the
New Task window. It is intended for public distribution only after every
protected release gate passes.

##### Highlights

- Desktop, Server, Docker, and Flatpak packages now use the verified Motrix
  aria2 fork `1.37.0-motrix.10`. Every supported platform asset is pinned by
  name, size, and SHA-256 digest in the engine lock.
- Motrix checks `aria2c --version` before starting the engine. A version must
  carry the Motrix suffix and the fork-only SQLite persistence feature to be
  recognized as the bundled fork; this detection does not depend on RPC, so an
  incompatible engine cannot crash before it is identified.
- When an upstream or otherwise non-Motrix aria2 executable is detected,
  Motrix warns the user and durably changes `max-connection-per-server` and
  `split` to the upstream limit of 16. The adjusted settings use the Custom
  performance profile so validation cannot restore an incompatible value.
- URI creation also handles aria2 error code 28 defensively. If a custom
  engine rejects connection options above 16, Motrix retries the request once
  with compatible values instead of losing the task.
- Engine-adopted parent tasks are persisted before task inspectors can save
  child files or peers. This removes the SQLite foreign-key race that could
  stop desktop or Server startup while recovering existing aria2 tasks
  ([#1920](https://github.com/agalwood/Motrix/issues/1920)).
- A new Lightweight mode can release the hidden main-window renderer while
  downloads continue. Background startup can remain headless when safe;
  Windows and Linux retain a tray entry, while macOS can reopen from the Dock.
- The New Task window reads the clipboard only when it opens, so editing the
  form no longer overwrites user input with later clipboard changes. Collapsing
  Advanced options now restores the compact window height.

##### Before testing

This is prerelease software. Back up existing Motrix application data and
downloads before installing it. Migration from Motrix v1 data has not yet been
validated, so do not use your only copy of v1 data with this beta.

When practical, test v2 in parallel using a separate OS account, machine, or
Docker data directory. Do not rely on this beta for your only copy of important
downloads.

If you replace the bundled `aria2c`, expect Motrix to limit connections to 16
unless the executable reports the Motrix fork version and persistence feature.

##### Planned downloads after release gates pass

| Distribution | Architectures | Planned output |
|--------------|---------------|----------------|
| macOS 12 or later | `arm64` (Apple Silicon), `x64` (Intel) | DMG and ZIP |
| Windows | `x64` | Unsigned NSIS installer (`.exe`) and ZIP |
| Linux | `x64`, `arm64` | AppImage, DEB, and RPM |
| Flatpak Native Host companion | `linux/x64`, `linux/arm64` | `Motrix-Native-Host-2.0.0-beta.22-linux-<arch>.tar.gz` |
| Docker Hub / GHCR | `linux/amd64`, `linux/arm64` | Immutable `2.0.0-beta.22` tag in both registries |
| Snap Store | — | Not published for this beta |

After every container gate passes, the versioned image references will be
`docker.io/motrixapp/motrix-server:2.0.0-beta.22` and
`ghcr.io/agalwood/motrix-server:2.0.0-beta.22`. See the
[Docker Server deployment guide](https://github.com/agalwood/Motrix/blob/v2.0.0-beta.22/docs/docker-server.md)
for storage, networking, and upgrade guidance.

##### Distribution notes

- AppImage desktop integration is opt-in and confined to the current user's
  XDG data directory. Browser-extension hand-off is not yet available from the
  AppImage package because its Native Messaging host does not have a stabl

_[Truncated at 4000 characters — full notes: https://github.com/agalwood/Motrix/releases/tag/v2.0.0-beta.22]_