Motrix 2.0.0-beta.22

English | 简体中文

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).
• 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

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
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 stable
  path outside the mounted image.
• Flatpak is validated separately and is not published by the release tag; the
  GitHub prerelease includes its Native Host companion archives.
• Windows arm64 and all 32-bit packages are not available.
• Windows packages are unsigned and may trigger a Windows SmartScreen warning.
  Download them only from the official GitHub prerelease after it is published.
• Beta container tags are immutable and do not update latest, stable, or
  other stable floating tags.
• Snap is not published for this beta. Prerelease Snap runs stop after source
  validation, so they do not build Snap artifacts, upload Store revisions, or
  change latest/edge.

Feedback

Please report reproducible problems through
GitHub Issues. Include your
operating system, architecture, package type, and the steps needed to reproduce
the issue.

What's Changed

• fix(add-task): restore window height after collapsing advanced by @agalwood in #1916
• feat: add lightweight desktop mode by @agalwood in #1917
• fix(engine): handle official aria2 limits and task adoption races by @agalwood in #1923
• chore(release): prepare 2.0.0-beta.22 by @agalwood in #1924

Full Changelog: v2.0.0-beta.21...v2.0.0-beta.22