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

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 #1902
• docs: fix text and emoji icon formatting issues by @Right202209 in #1903
• fix: persist settings and align desktop window controls by @agalwood in #1906
• chore(engine): bump bundled aria2 to 1.37.0-motrix.5 by @agalwood in #1907
• feat(logging): centralize structured log redaction by @agalwood in #1908
• feat(downloads): add performance profiles and 64-connection tuning by @agalwood in #1909
• fix(linux): restore aria2 CA trust store support by @agalwood in #1913
• chore(release): prepare 2.0.0-beta.20 by @agalwood in #1914
• fix(release): prepare beta.21 AppImage recovery by @agalwood in #1915

New Contributors

• @Right202209 made their first contribution in #1903

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