v2.0.0-beta.31

Motrix 2.0.0-beta.31

English | 简体中文

Motrix 2.0.0-beta.31 is a reliability and desktop-polish update. It improves
durable download finalization, fixes Motrix Extension startup in Docker,
aligns window state and first-run styling across themes, and refreshes the
Windows installer experience. It is intended for public distribution only
after every protected release gate passes.

Highlights

• Download finalization now uses a same-filesystem move when possible instead
  of copying the completed payload. The durable journal records that choice,
  recovery can restore an interrupted move safely, and task state is committed
  without mutating the live task before the filesystem transaction succeeds
  (#2056).
• Headless Server containers can start the explicitly enabled remote Motrix
  Extension bridge on the container interface used by Docker port publishing.
  Startup diagnostics now identify the bridge ownership stage and fixed reason,
  and the deployment guide documents safe recovery of a stale or invalid
  ownership record
  (#2055).
• Desktop windows select the correct solid background before the renderer
  mounts, preventing a light flash in dark mode. Fullscreen transitions now
  keep custom title-bar controls in sync, hide controls and drag regions while
  fullscreen, and avoid a duplicate macOS fullscreen menu item
  (#2057,
  #2062).
• Downloads handed off by Motrix Extension now inherit the application-wide
  split and per-server connection settings instead of being forced to a single
  connection (#2062).
• The first-run disclaimer restores its intended light appearance and readable
  highlight contrast in dark mode. English and Simplified Chinese copy also
  receive small punctuation corrections
  (#2052,
  #2062).
• The assisted Windows installer now includes branded header and sidebar
  artwork (#2062).

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 large completed downloads,
recovery after an interrupted finalization, remote Motrix Extension pairing in
Docker, Extension downloads with custom connection settings, dark-mode startup,
fullscreen transitions, first-run onboarding, and the Windows installer.

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.31 revision set.

Planned downloads after release gates pass

Distribution	Architectures	Planned output
macOS 13 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.31-linux-<arch>.tar.gz
Docker Hub / GHCR	linux/amd64, linux/arm64	Immutable 2.0.0-beta.31 tag in both registries
Snap Store	amd64, arm64	Verified build set on latest/edge

After every container gate passes, the versioned image references will be
docker.io/motrixapp/motrix-server:2.0.0-beta.31 and
ghcr.io/agalwood/motrix-server:2.0.0-beta.31. See the
Docker Server deployment guide
for storage, networking, remote Extension pairing, 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(server): support Docker extension bridge startup by @agalwood in #2055
• chore(l10n): fix some quotes in english and simpchinese by @3gf8jv4dv in #2052
• fix(task): repair durable finalize and avoid copies by @agalwood in #2056
• fix(window): align startup themes and fullscreen chrome by @agalwood in #2057
• fix: address desktop onboarding, bridge, and installer issues by @agalwood in #2062
• chore(release): prepare 2.0.0-beta.31 by @agalwood in #2064

Full Changelog: v2.0.0-beta.30...v2.0.0-beta.31