Motrix 2.0.0-beta.28

English | 简体中文

Motrix 2.0.0-beta.28 resolves beta blockers in direct-download naming and
finalization, RPC lifecycle, proxy handling, Windows networking and
integration, and Snap publication. It is intended for public distribution only
after every protected release gate passes.

Highlights

• HTTP(S) downloads now derive safe final filenames after redirects, request
  rewriting, plugin hooks, and proxy-aware remote metadata probes. Explicit
  user filenames remain authoritative, while failed probes retain a safe
  URL-based fallback
  (#1976).
• The Files inspector keeps the logical HTTP/FTP destination name instead of
  exposing aria2's temporary .motrix suffix. Finalization rebases persisted
  file records after a successful rename without changing BitTorrent, Magnet,
  or multiplexed-download paths
  (#2001).
• An explicitly empty RPC password now enables intentional no-token mode.
  Motrix still binds aria2 RPC to loopback, disables permissive cross-origin
  access, refreshes the RPC client before the first call to a restarted engine,
  and coalesces concurrent restart requests
  (#1987,
  #1988).
• Native BitTorrent traffic has the same boundary regardless of the selected
  proxy: peer connections, DHT, and UDP trackers remain direct. Only HTTP(S)
  requests associated with a torrent, such as HTTP(S) trackers and Web Seeds,
  can use the download proxy. This release adds an authenticated loopback HTTP
  bridge so SOCKS5 also works for regular HTTP(S) downloads, tracker-list
  refreshes, and that BitTorrent HTTP(S) traffic. Per-listener authentication
  is generated in memory and removed when the bridge stops
  (#1977).
• Motrix now uses @motrix/nat@0.1.1, improving Windows default-route
  selection and NAT mapping in multi-adapter environments such as Tailscale
  (#1999).
• Windows CLI discovery now starts native executables directly and reserves
  cmd.exe for batch shims, fixing Node.js paths under Program Files
  (#1998).
• The Windows installer restores the dedicated .torrent association icon
  while preserving the installer-owned Default Apps design
  (#2003).
• The Downloads page restores its empty state when only removed records remain.
  Protected beta tags also use the Store's scoped edge channel correctly when
  publishing the verified two-architecture Snap set to latest/edge
  (#1997,
  #1996,
  #2002).

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. Pay particular attention to redirected HTTP downloads,
downloads using each proxy protocol, the documented BitTorrent proxy boundary,
RPC no-token mode, engine restarts, and Windows networking or file
associations relevant to your environment.

After the protected release completes, Snap testers can install the strictly
confined build with sudo snap install motrix --edge. Existing installations
tracking latest/edge should upgrade to the same beta.28 revision set.

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.28 and
ghcr.io/agalwood/motrix-server:2.0.0-beta.28. 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.
• The Snap package is strictly confined. Its approved personal-files
  interface is limited to registering Native Messaging host manifests for
  supported browsers. Beta publication updates latest/edge only; it does not
  promote the build to candidate or stable.

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(snap): honor scoped edge channel credentials by @agalwood in #1996
• fix(cli): spawn windows executables directly by @agalwood in #2000
• fix: resolve beta blockers in downloads, RPC, NAT, and proxy by @agalwood in #2002
• chore(release): prepare 2.0.0-beta.28 by @agalwood in #2004

Full Changelog: v2.0.0-beta.27...v2.0.0-beta.28

Motrix 2.0.0-beta.27

English | 简体中文

Motrix 2.0.0-beta.27 enables protected beta releases to publish verified
amd64 and arm64 Snap builds to the Snap Store, adds GeoIP support to the
Headless Server, and improves aria2 behavior, Windows integration, typography,
packaging, and desktop details. It is intended for public distribution only
after every protected release gate passes.

Highlights

• Protected stable and beta tags now build, verify, and upload one complete
  two-architecture Snap set before releasing its exact revisions to
  latest/edge. Pull requests and manual runs remain build-only, and
  candidate or stable promotion continues to reuse the already verified
  revisions.
• The Headless Server now exposes the same GeoIP and peer queries as the
  Electron app, forwards GeoIP events, closes the manager cleanly during
  shutdown, and prints a copyable Server URL when it starts. Its Add Task
  dialog now follows the desktop layout and animation behavior
  (#1986).
• aria2 runtime defaults are aligned across new and existing profiles, while
  BitTorrent preview and file-selection behavior more consistently follows the
  task's authoritative metadata
  (#1982).
• New HTTP downloads now honor the active performance profile's connection
  count instead of overriding it with five connections
  (#1989).
• The Files inspector now restores indexed single-file torrent names, refreshes
  live progress, and preserves the display order of bracketed file names
  (#1991,
  #1992).
• The Info Hash copy action now copies the raw hash. Selecting SOCKS5 no longer
  sends an unsupported proxy option to the download engine, while app-update
  and tracker proxy scopes remain available
  (#1990,
  #1994).
• The development runner now uses cross-spawn, allowing pnpm start to
  resolve its child command correctly on Windows
  (#1981).
• Windows 11 default-app detection now prefers UserChoiceLatest, the CLI
  refreshes its Node path discovery, and concurrent directory-picker requests
  no longer open duplicate native dialogs
  (#1967,
  #1973).
• Cross-platform font fallbacks now preserve bundled Inter text while choosing
  appropriate native CJK fonts for the active platform and locale
  (#1972).
• Server artifacts now include the Motrix license, and the desktop preserves
  its window title while exposing favicon and Apple touch icons
  (#1983).

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.

After the protected release completes, Snap testers can install the strictly
confined build with sudo snap install motrix --edge. Verify that normal
downloads, removable media, and browser Native Messaging integration behave as
expected. Existing installations tracking latest/edge should upgrade to the
same beta.27 revision set.

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.27 and
ghcr.io/agalwood/motrix-server:2.0.0-beta.27. 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.
• The Snap package is strictly confined. Its approved personal-files
  interface is limited to registering Native Messaging host manifests for
  supported browsers. Beta publication updates latest/edge only; it does not
  promote the build to candidate or stable.

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(windows): address picker, CJK, and association issues by @agalwood in #1967
• fix(renderer): unify cross-platform font fallbacks by @agalwood in #1972
• fix(cli): refresh windows path for node detection by @agalwood in #1973
• feat(aria2): align runtime defaults and BT preview policy by @agalwood in #1982
• docs: add review FAQ and troubleshooting to issue template by @3gf8jv4dv in #1980
• fix(build): include the Motrix license in Server artifacts by @agalwood in #1983
• feat(server): add GeoIP support and align Add Task dialog by @agalwood in #1986
• chore(release): prepare 2.0.0-beta.27 by @agalwood in #1995

New Contributors

• @3gf8jv4dv made their first contribution in #1980

Full Changelog: v2.0.0-beta.26...v2.0.0-beta.27

Motrix 2.0.0-beta.26

English | 简体中文

Motrix 2.0.0-beta.26 makes interrupted direct-download recovery safer, adds
system default-app controls on Windows and Linux, uses each platform's
Downloads directory for new installations, and refreshes several Settings
details. It is intended for public distribution only after every protected
release gate passes.

Highlights

• Interrupted HTTP and FTP downloads now persist a non-sensitive replay
  recipe and remote resource validators. On restart, Motrix inspects the
  partial file, aria2 checkpoint, final-path conflicts, range support, and the
  remote ETag or modification time before resuming. If identity or credentials
  cannot be verified safely, the partial file is preserved and Motrix reports
  why manual recovery is required
  (#1959).
• Integration settings now report whether Motrix owns .torrent files and
  magnet: links on Windows and Linux. Windows opens the appropriate Default
  Apps page without rewriting protected UserChoice values. Native Linux
  packages can set the .torrent default through xdg-mime, while AppImage
  integration preserves and restores verified previous handlers
  (#1957).
• New installations now default downloads to the operating system's Downloads
  directory instead of assuming <home>/Downloads. Existing saved paths are
  preserved, and confined Snap packages retain their stable real-home default
  (#1958).
• Compact selectors in Settings expand to fit localized labels instead of
  clipping longer translations
  (#1955).
• Built-in Chrome, Firefox, Safari, and Transmission User-Agent presets have
  been refreshed (#1960).

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.

To test recovery, interrupt an HTTP or FTP download after it has written both a
partial file and an aria2 checkpoint, then restart Motrix and confirm that the
task resumes without discarding progress. Also test a changed remote resource
or missing checkpoint and confirm that Motrix preserves the partial file rather
than combining incompatible bytes. On Windows and Linux, review the default-app
status under Integration settings and verify .torrent and magnet: hand-off.

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.26 and
ghcr.io/agalwood/motrix-server:2.0.0-beta.26. 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(settings): adapt select widths to localized text by @agalwood in #1955
• feat(platform): add system default app controls by @agalwood in #1957
• fix(settings): use platform downloads directory by @agalwood in #1958
• fix(downloads): harden interrupted task recovery by @agalwood in #1959
• fix(settings): refresh user-agent presets by @agalwood in #1960
• chore(release): prepare 2.0.0-beta.26 by @agalwood in #1962

Full Changelog: v2.0.0-beta.25...v2.0.0-beta.26

Motrix 2.0.0-beta.25

English | 简体中文

Motrix 2.0.0-beta.25 strengthens BitTorrent and Magnet task identity, recovery,
and storage safety; modernizes AppImage distribution; and refines several
desktop controls. It is intended for public distribution only after every
protected release gate passes.

Beta.24 did not reach public distribution because the protected Linux smoke
test looked for the AppStream application ID (app.motrix.native.desktop)
instead of electron-builder's actual AppImage desktop entry
(motrix.desktop). Beta.25 carries the same user-facing changes and corrects
that release-only assertion; both AppImage architectures must still pass the
complete no-FUSE extraction gate before publication.

Highlights

• BitTorrent payloads now use a fixed-length internal staging workspace with
  validated per-file output mappings. Final names are restored after
  completion, and failed Magnet metadata resolution can be retried safely with
  a fresh engine task (#1930,
  #1932).
• Magnet-to-BT conversion immediately persists aria2's authoritative file
  paths, sizes, and selection state. Domain file indexes consistently remain
  zero-based, including restore and reseed paths
  (#1934,
  #1937).
• Re-adding the same torrent now compares its info hash, destination, and file
  selection. Motrix reuses or focuses a compatible task, verifies completed
  data before reuse, and reports explicit conflicts for incompatible copies or
  leftover files instead of silently downloading a numbered duplicate. The
  internal staging path no longer leaks a bare aria2 GID
  (#1939).
• AppImages now use static x64 and arm64 runtimes, include native zsync update
  metadata, and support extraction on current Linux systems without depending
  on FUSE 2 (#1898,
  #1899,
  #1933).
• Windows caption controls use compact Chromium-inspired glyphs and stay in
  sync when the window is maximized, restored, or resized
  (#1925,
  #1935).
• The activity heatmap omits a partial leading month label when it would
  overlap the next month (#1936,
  #1938).
• New Task file-type filters now show consistent tooltips
  (#1939).

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.

For BitTorrent testing, add the same Magnet link more than once with matching
and different destinations or file selections. Confirm that compatible tasks
are reused, incompatible copies require an explicit choice, and completed data
is checked before reuse. Historical tasks with empty file metadata can only be
repaired while aria2 still retains their result; otherwise remove the old task
and re-add the Magnet link. On Linux, also verify AppImage extraction, desktop
integration, and update checks on the architectures you use.

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.25 and
ghcr.io/agalwood/motrix-server:2.0.0-beta.25. 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(bt): avoid long paths and retry magnet metadata by @agalwood in #1932
• fix(linux): modernize AppImage distribution by @agalwood in #1933
• fix(window): refine Windows caption controls by @agalwood in #1935
• fix(bt): persist magnet file metadata by @agalwood in #1937
• fix(dashboard): omit partial leading month label in activity heatmap by @Justin24506 in #1938
• fix(bt): prevent duplicate torrent tasks and path conflicts by @agalwood in #1939
• chore(release): prepare 2.0.0-beta.24 by @agalwood in #1940
• fix(release): prepare beta.25 AppImage recovery by @agalwood in #1941

New Contributors

• @Justin24506 made their first contribution in #1938

Full Changelog: v2.0.0-beta.23...v2.0.0-beta.25

Motrix 2.0.0-beta.23

English | 简体中文

Motrix 2.0.0-beta.23 adds control over downloaded-file modification times,
aligns launch and tray behavior with each desktop operating system, makes
Settings controls more compact and consistent, and fixes New Task window
shrinking on Windows. It is intended for public distribution only after every
protected release gate passes.

Highlights

• Downloads can now choose the modification time used for completed HTTP and
  FTP files. Local is the default and keeps the download completion time;
  Server applies the remote Last-Modified timestamp when one is available
  (#1542).
• Appearance now uses platform-native launch terminology. macOS offers Dock
  and Menu Bar combinations, while Windows and Linux offer opening the main
  window or starting in the system tray. Linux also explains that tray support
  depends on the desktop environment.
• Windows and Linux always retain a tray entry as a reliable way to reopen
  Motrix, including when an old settings file contains the macOS-only hidden
  tray value. A Linux tray click now toggles the main window, and context-menu
  handling uses the events supported by each operating system.
• Settings use more consistent widths for short numeric fields and compact
  selectors. Speed-limit reset actions are grouped before their values, with
  separate meanings for unlimited standard limits and inherited low-speed
  limits.
• The non-resizable New Task window now shrinks through a bounds update that
  preserves its current position. This fixes the collapsed window height on
  Windows while preserving the existing macOS animation behavior
  (#1879).

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.

To test file times, download an HTTP or FTP resource that supplies a
Last-Modified value, then compare the Local and Server choices under
Downloads settings. Also verify that the Appearance launch mode and tray click
behavior match your desktop environment.

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.23 and
ghcr.io/agalwood/motrix-server:2.0.0-beta.23. 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): shrink non-resizable window on Windows by @agalwood in #1926
• feat(settings): polish platform and download controls by @agalwood in #1928
• chore(release): prepare 2.0.0-beta.23 by @agalwood in #1929

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

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

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

Motrix 2.0.0-beta.19

English | 简体中文

Motrix 2.0.0-beta.19 makes the in-app updater hand off to the installer
reliably, restores clipboard link autofill in New Task, tightens plugin and
task-removal safety, and fixes tray and window-control behavior across
platforms. It is intended for public distribution only after every protected
release gate passes.

Highlights

• Restart and install now completes the update handoff reliably: the
  updater prepares the quit policy before installing, so hide-to-tray windows
  close instead of leaving the old version running. The About dialog's update
  action and channel selector are consolidated into one compact control.
• Opening New Task on the Links tab with an empty URL field reads the
  clipboard once and autofills it when every non-empty line is a downloadable
  link (http/https/ftp/magnet). This restores the v1 behavior, is
  gated by a new General setting (default on), and never watches the
  clipboard in the background.
• Each line pasted on the Links tab now creates its own independent task
  instead of being submitted as mirrors of one file. Partial failures are
  reported with created/failed counts.
• Removing tasks never pre-checks Delete downloaded files based on task
  status. Deleting data is always an explicit opt-in; only the Shift shortcut
  pre-checks the box.
• Plugins' HTTP access is now limited to the hostPermissions declared in
  their manifest, enforced on the initial URL and on every redirect hop.
• The Pieces tab now covers HTTP downloads as well as BitTorrent tasks, piece
  length survives restore, and duplicate aria2 rows are reconciled by GID
  during session restore so stale history cannot overwrite a paused task.
• Downloads handed over from the browser extension are deduplicated by
  idempotency key, so bridge retries cannot create duplicate tasks.
• Tray behavior is fixed: left-clicking the tray icon toggles the window
  again, and macOS preserves the tray icon position.
• Window controls follow Motrix's own theme: Windows caption symbols use the
  app's resolved light/dark theme and refresh on theme change, Linux caption
  controls use the theme foreground color, and title-bar alignment is refined
  on both platforms.
• The dashboard activity tooltip no longer triggers a resize loop when moving
  quickly across cells.

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.19 and
ghcr.io/agalwood/motrix-server:2.0.0-beta.19. See the
Docker Server deployment guide
for storage, networking, and upgrade guidance.

Distribution notes

• AppImage is not published for this beta.
• 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(tray): preserve macos icon position by @agalwood in #1874
• feat(bridge): idempotent download/add via IdempotencyCache by @agalwood in #1877
• feat(downloads): show HTTP piece progress reliably by @agalwood in #1878
• fix: improve window controls and refresh dependencies by @agalwood in #1886
• fix(tray): restore window toggle on left click by @tahazarif10 in #1885
• fix: enforce plugin host permissions, per-line task creation, safe remove default by @agalwood in #1888
• feat(add-task): autofill clipboard link when the dialog opens by @agalwood in #1889
• fix(updater): make update flow reliable by @agalwood in #1890
• fix(dashboard): prevent activity tooltip resize loop by @agalwood in #1893
• fix: sync and align window controls by @agalwood in #1894
• chore(release): prepare 2.0.0-beta.19 by @agalwood in #1895

New Contributors

• @tahazarif10 made their first contribution in #1885

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

Motrix 2.0.0-beta.18

English | 简体中文

Motrix 2.0.0-beta.18 updates the bundled aria2 engine and improves DNS
resolution reliability. It is intended for public distribution only after
every protected release gate passes.

Highlights

• Updates the bundled desktop aria2 engine to 1.37.0-motrix.4, with pinned
  archives and binary checksums for every supported target.
• Adds Auto, System DNS, and Built-in DNS choices under Network
  settings on both the desktop app and Server web UI.
• In Auto mode, Motrix starts with aria2's built-in asynchronous resolver. If
  aria2 cannot contact any DNS server, Motrix switches the active engine
  session to the system resolver and retries the affected task once.
• Limits automatic fallback to recognized DNS transport failures. Deterministic
  DNS answers and unrelated network failures are not retried, and each task is
  retried at most once per session.
• Adds a localized notification when an automatic DNS fallback retry occurs.
• Adds Traditional Chinese (zh-TW) throughout the application.
• Expands the Plugin SDK development guide with clearer setup, capability,
  sandbox, packaging, and distribution guidance.

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.18 and
ghcr.io/agalwood/motrix-server:2.0.0-beta.18. See the
Docker Server deployment guide
for storage, networking, and upgrade guidance.

Distribution notes

• AppImage is not published for this beta.
• 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(i18n): add Traditional Chinese translation by @ChiahongHong in #1869
• feat(engine): add dns resolution mode with auto fallback by @agalwood in #1870
• chore(engine): bump bundled aria2 to 1.37.0-motrix.4 by @agalwood in #1871
• chore(release): prepare 2.0.0-beta.18 by @agalwood in #1872

New Contributors

• @ChiahongHong made their first contribution in #1869

Full Changelog: v2.0.0-beta.17...v2.0.0-beta.18

Motrix 2.0.0-beta.17

English | 简体中文

Motrix 2.0.0-beta.17 is the next Motrix Turbo beta intended for public
distribution only after every protected release gate passes. It fixes the
non-artifact failure observed after beta.16 had already published and signed
its two-registry container index, without moving or reusing the immutable
v2.0.0-beta.16 tag.

The beta.16 historical record
documents the successful desktop, GitHub prerelease, R2, native platform,
cross-registry index, provenance, SBOM, and signature stages, followed by the
HTTP 403 that prevented the final public runtime matrix from starting.

Release-gate recovery

• Removes Docker Hub repository-description mutation from the release
  workflow. Repository description and overview are publisher metadata, not
  versioned OCI artifacts, and their administrative access boundary is
  separate from image publication.
• Makes anonymous signature verification the final step of the single
  container finalize job. A successful finalize result and its verified digest
  can therefore hand off directly to the native public runtime matrix.
• Adds a workflow contract that rejects the removed Docker Hub login route,
  repository-description payload, or description step if they return to the
  security-critical release path.
• Keeps failures visible and fail-closed. The change does not use
  continue-on-error, does not weaken an artifact, signature, provenance,
  SBOM, platform, anonymous-pull, or runtime check, and does not broaden
  release access.

Native container publication

• Builds linux/amd64 on ubuntu-22.04 and linux/arm64 on
  ubuntu-22.04-arm. Each job proves its GitHub-hosted Linux runner and native
  architecture before Buildx starts. The container release path does not
  install or invoke QEMU.
• Pushes each successful platform only by its untagged, content-addressed OCI
  digest to Docker Hub and GHCR. A single architecture never receives the
  public version tag and cannot become the official release by itself.
• Anonymously pulls the exact staged digest from both registries and runs the
  complete Server runtime smoke on its native runner. Platform metadata is
  emitted only after both registry smokes succeed.
• Binds each platform record to the exact version, source commit, workflow run
  and attempt, native runner identity, raw OCI index hash, image manifest,
  attestation manifest, max-level provenance, and non-empty SPDX SBOM.
• Allows the single finalize job to proceed only after the complete
  amd64/arm64 set succeeds. Missing, duplicate, unexpected, cross-wired,
  shared, ambiguous, conflicting, or future-attempt data fails closed before
  either version tag can be created.
• Rechecks both immutable version tags immediately before finalization. A clean
  run creates both indexes; a rerun resumes an identical complete result or
  repairs one missing registry from the verified existing index. A conflicting
  immutable tag fails closed.
• Requires Docker Hub and GHCR to expose the same final index digest, platform
  manifests, attestation manifests, provenance, and SBOM set before signing.
  Both signatures are then verified anonymously.
• Runs the complete final public Server runtime smoke on native amd64 and arm64
  runners against the exact signed digest in both registries.
• Advances stable floating aliases only in the last recovery-safe job after
  every build, index, signature, provenance, SBOM, anonymous pull, and runtime
  gate passes. Beta releases publish only their immutable version tag, so
  beta.17 does not update latest, stable, or another stable alias.

The GitHub prerelease, R2 update feed, container registries, and Snap Store
remain independently gated publication channels. Their individual safety and
recovery rules are strict, but this release does not claim cross-channel
atomicity.

Snap beta policy

Snap is not part of the beta.17 distribution. Protected prerelease Snap runs
stop after source validation, so they do not build Snap artifacts, upload
Store revisions, or change latest/edge.

Highlights

• A ground-up desktop rebuild with Electron 43, React 19, and TypeScript 7,
  including a customizable Dashboard, dark mode, a cross-platform application
  menu, and clearer task-inspector feedback.
• One host-neutral download core for both the desktop app and the Node/Web
  Server, with SQLite session recovery, tracker management, UPnP/NAT-PMP, and
  HTTP, FTP, BitTorrent, and magnet support.
• MDXP-based integration for the official CLI and browser handoff, including
  local discovery and device-code pairing for remote Server instances.
• A QuickJS plugin sandbox with capability consent, bundled builtin plugins,
  and an in-app plugin marketplace.
• Persistent multi-platform Server containers for NAS and home-server
  deployments, published only after the complete native architecture set and
  every public verification gate pass.

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.17 and
ghcr.io/agalwood/motrix-server:2.0.0-beta.17. See the
Docker Server deployment guide
for storage, networking, and upgrade guidance.

Known distribution limits

• AppImage is not published for this beta.
• 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 without building or publishing Snap artifacts.

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(release): unblock container runtime verification by @agalwood in #1868

Full Changelog: v2.0.0-beta.16...v2.0.0-beta.17