- Check aria2c version before starting engine to verify Motrix fork with SQLite persistence feature
- Add Lightweight mode to release hidden main-window renderer while downloads continue
- Update bundled download engine to aria2 1.37.0-motrix.10
- Limit max-connection-per-server and split to 16 when non-Motrix aria2 executable is detected
- Handle aria2 error code 28 defensively by retrying URI creation with compatible connection values
- Persist engine-adopted parent tasks before task inspectors can save child files or peers to prevent SQLite foreign-key race
- Read clipboard only when New Task window opens to prevent editing form from being overwritten by clipboard changes
- Restore compact window height after collapsing Advanced options in New Task window
From Motrix
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 --versionbefore 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-serverandsplitto 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
| 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
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
arm64and 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 https://github.com/agalwood/Motrix/pull/1916
- feat: add lightweight desktop mode by @agalwood in https://github.com/agalwood/Motrix/pull/1917
- fix(engine): handle official aria2 limits and task adoption races by @agalwood in https://github.com/agalwood/Motrix/pull/1923
- chore(release): prepare 2.0.0-beta.22 by @agalwood in https://github.com/agalwood/Motrix/pull/1924
Full Changelog: https://github.com/agalwood/Motrix/compare/v2.0.0-beta.21...v2.0.0-beta.22