Motrix v2.0.0-beta.21

Motrix 2.0.0-beta.21

English | 简体中文

Motrix 2.0.0-beta.21 restores verified HTTPS downloads across Linux distributions, adds performance profiles with up to 64 connections, makes settings and engine recovery more reliable, redacts sensitive log data, and returns AppImage packages with user-controlled desktop integration. It is intended for public distribution only after every protected release gate passes.

Beta.20 did not reach public distribution because release assembly rejected electron-builder's valid AppImage-first Linux update metadata. Beta.21 carries the same user-facing changes and normalizes those compatibility fields to the DEB updater asset before final verification and publication.

Highlights

• Linux launches aria2 with a fresh CA bundle assembled from the system trust store on every run, falling back to bundled roots when necessary. This fixes valid HTTPS downloads on distributions where the static engine's build-time OpenSSL paths do not exist, without disabling certificate verification.
• Desktop, Server, Docker, and Flatpak packages use the Motrix aria2 fork 1.37.0-motrix.6. Server and Docker packages carry the verified Motrix binary instead of depending on a distribution-provided aria2 executable.
• Download settings offer Automatic, Balanced, High speed, Maximum, and Custom performance profiles. They coordinate connections, segments, minimum segment size, and disk cache; the bundled engine supports up to 64 connections per server and Automatic mode applies disk-aware startup tuning.
• Settings are saved before an engine restart is requested. Options that aria2 can apply immediately are updated in place, while settings requiring a restart keep a durable reminder. Connection, allocation, and cache choices remain consistent after saving and relaunching.
• Application and plugin logs share a structured redaction boundary. Secrets, credentials, cookies, request bodies, storage values, sensitive paths, and URL query data are removed while safe diagnostic context is retained.
• AppImage publishing is restored for Linux x64 and arm64. On first launch, users may opt in to a desktop entry, icon, and motrix:, magnet:, and .torrent handlers under their own XDG data directory; the integration can be enabled, repaired, or removed later from Settings.
• Release assembly accepts electron-builder's AppImage-first source metadata, validates every referenced Linux asset, and emits DEB-based compatibility fields for the updater. Final release verification remains strict.
• Tracker state cached before an engine interruption is reapplied after recovery. Expected engine-shutdown errors are suppressed, NAT mappings retry after discovery, and download counts follow Motrix task state.
• Windows and Linux caption controls use consistent 28px targets and align with sidebar and panel actions. Toast and content safe areas account for the custom window chrome.

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.

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.21-linux-<arch>.tar.gz
Docker Hub / GHCR	linux/amd64, linux/arm64	Immutable 2.0.0-beta.21 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.21 and ghcr.io/agalwood/motrix-server:2.0.0-beta.21. 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

• feat(appimage): desktop self-integration, release re-enable, and settings toggle by @agalwood in https://github.com/agalwood/Motrix/pull/1902
• docs: fix text and emoji icon formatting issues by @Right202209 in https://github.com/agalwood/Motrix/pull/1903
• fix: persist settings and align desktop window controls by @agalwood in https://github.com/agalwood/Motrix/pull/1906
• chore(engine): bump bundled aria2 to 1.37.0-motrix.5 by @agalwood in https://github.com/agalwood/Motrix/pull/1907
• feat(logging): centralize structured log redaction by @agalwood in https://github.com/agalwood/Motrix/pull/1908
• feat(downloads): add performance profiles and 64-connection tuning by @agalwood in https://github.com/agalwood/Motrix/pull/1909
• fix(linux): restore aria2 CA trust store support by @agalwood in https://github.com/agalwood/Motrix/pull/1913
• chore(release): prepare 2.0.0-beta.20 by @agalwood in https://github.com/agalwood/Motrix/pull/1914
• fix(release): prepare beta.21 AppImage recovery by @agalwood in https://github.com/agalwood/Motrix/pull/1915

New Contributors

• @Right202209 made their first contribution in https://github.com/agalwood/Motrix/pull/1903

Full Changelog: https://github.com/agalwood/Motrix/compare/v2.0.0-beta.19...v2.0.0-beta.21