# Motrix v2.0.0-beta.31

- Product: Motrix (https://whatsnew.fyi/product/motrix)
- Vendor: agalwood
- Date: 2026-09-04
- Version: v2.0.0-beta.31
- Original notes: https://github.com/agalwood/Motrix/releases/tag/v2.0.0-beta.31
- Permalink: https://whatsnew.fyi/product/motrix/releases/v2.0.0-beta.31
- Labels: Pre-release

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **changed** — Download finalization now uses a same-filesystem move when possible instead of copying the completed payload
- **changed** — Durable journal records the finalization choice and recovery can restore an interrupted move safely
- **changed** — Task state is committed without mutating the live task before the filesystem transaction succeeds
- **fixed** — Headless Server containers can start the explicitly enabled remote Motrix Extension bridge on the container interface used by Docker port publishing
- **changed** — Startup diagnostics now identify the bridge ownership stage and fixed reason
- **fixed** — Desktop windows select the correct solid background before the renderer mounts, preventing a light flash in dark mode
- **changed** — 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
- **changed** — 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
- **fixed** — First-run disclaimer restores its intended light appearance and readable highlight contrast in dark mode
- **changed** — Windows installer now includes branded header and sidebar artwork

#### Motrix 2.0.0-beta.31

English | [简体中文](https://github.com/agalwood/Motrix/blob/v2.0.0-beta.31/docs/release-notes/2.0.0-beta.31.zh-CN.md)

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](https://github.com/agalwood/Motrix/pull/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](https://github.com/agalwood/Motrix/pull/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](https://github.com/agalwood/Motrix/pull/2057),
  [#2062](https://github.com/agalwood/Motrix/pull/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](https://github.com/agalwood/Motrix/pull/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](https://github.com/agalwood/Motrix/pull/2052),
  [#2062](https://github.com/agalwood/Motrix/pull/2062)).
- The assisted Windows installer now includes branded header and sidebar
  artwork ([#2062](https://github.com/agalwood/Motrix/pull/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

_[Truncated at 4000 characters — full notes: https://github.com/agalwood/Motrix/releases/tag/v2.0.0-beta.31]_