Motrix 2.0.0-beta.38

English | 简体中文

Motrix 2.0.0-beta.38 preserves the macOS menu-bar icon position, improves
Windows SMB download finalization and recovery, and refreshes the dependency
stack. It also includes the settings and connection-feedback improvements
prepared for beta.37.

Beta.37 was abandoned: its desktop, update-feed, and container release workflow
was cancelled before publication. Snap latest/edge had already received
beta.37; beta.38 supersedes that build set. The beta.37 tag remains unchanged.

Highlights

• On macOS, the menu-bar icon keeps its saved position across normal app exits
  and transitions through Dock-only Run Mode
  (#2131).
• Windows download finalization supports SMB shares, including UNC and mapped
  drive paths. Recovery retries eligible failed finalization journals while
  preserving file-identity and replacement safeguards
  (#2132).
• Dependencies are refreshed from a clean install, including Electron 44.3.0,
  React 19.3, Vite 8.3, Vitest 5, and pnpm 12.4.1. Compatible Zod dependencies
  share one version, and Flatpak source generation retains both documents in
  pnpm 12's lockfile. CI, signing inputs, and offline packaging use the matching
  pinned tool versions and checksums.
• Invalid settings show localized field errors and block saving. Download,
  network, proxy, BitTorrent, media-tool, and GeoIP settings use shared validation
  constraints while preserving the compact form layout
  (#2126).
• Download settings distinguish maximum connections from active connections,
  add 20/30 concurrent-download presets, and default new settings to 10 concurrent
  downloads. Existing saved values are preserved. Custom values support 1–100
  concurrent downloads and 1–128 connections per file
  (#2126).
• Empty or stale tracker lists can synchronize three seconds after persisted
  consent and engine readiness. Synchronization progress remains visible after
  opening the page or reconnecting, in both Desktop and Server
  (#2126).
• Tracker sources distinguish Direct and CDN addresses. Optional
  animeTrackerList sources and its default-enabled CDN blacklist are added
  without overwriting existing source choices
  (#2126).
• Unavailable NAT mapping uses a neutral status with download-impact guidance,
  retained retry counts, and links to retry, network settings, and the manual.
  This changes the feedback; router mapping availability is unchanged
  (#2126).
• The bilingual bridge protocol now explicitly retains pairing through app exit,
  browser restart, and failed discovery, and separates app wake from first
  pairing. This is a documentation clarification; browser reconnect behavior
  depends on the companion Extension update
  (#2129).

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. Check invalid settings and custom connection limits,
tracker progress after first-run consent and navigation, existing tracker source
choices after upgrading, and NAT recovery guidance. Also check macOS tray position
after restarting or changing Run Mode, and completing or recovering downloads
on Windows SMB shares after a restart or a temporary share disconnection.

Browser reconnect after app exit requires a compatible companion Extension.
The bridge documentation change in this beta does not itself alter the App
runtime or the wire protocol.

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

Distribution notes

• AppImage desktop integration remains opt-in. Browser cold launch uses a
  separately enabled stable Native Messaging host and a registered AppImage path;
  saved-pairing reconnect needs the compatible companion Extension update.
• 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(settings): clarify validation and connection feedback by @agalwood in #2126
• docs(bridge): clarify retained pairing and app wake lifecycle by @agalwood in #2129
• chore(release): prepare 2.0.0-beta.37 by @agalwood in #2130
• fix(tray): preserve macos menu bar position by @agalwood in #2131
• fix(finalize): support smb shares and recover failed journals by @agalwood in #2132
• chore(release): prepare 2.0.0-beta.38 by @agalwood in #2133

Full Changelog: v2.0.0-beta.36...v2.0.0-beta.38