Skip to content

deps(macos-x64): FFmpeg with SVT-AV1, so AV1 works on Intel Macs (deps 1.17.0-rc2) - #208

Merged
StuartCameronCode merged 4 commits into
mainfrom
stuart/45-macos-x64-deps-ffmpeg-without-svt-av1-ev
Nov 16, 2026
Merged

StuartCameronCode merged 4 commits into
mainfrom
stuart/45-macos-x64-deps-ffmpeg-without-svt-av1-ev

Conversation

@StuartCameronCode

Copy link
Copy Markdown
Owner

Summary

The macOS x64 deps bundle shipped evermeet.cx's static FFmpeg 9.0.1, which has no libsvtav1. So the AV1 output added in task #40 showed as unavailable on Intel Macs, and the worker refused AV1 jobs there. This PR switches the x64 FFmpeg to martin-riedl.de's static amd64 build, from the same host as arm64. That build has SVT-AV1 v4.2.0. It ships in deps 1.17.0-rc2, which is already published as a prerelease.

  • Scripts/download-deps-macos.sh:
    • x64 FFmpeg is pinned to build 1789931006_9.0.2 by build ID and by a SHA-256 for each zip.
    • New assert_ffmpeg_encoder: the deps build fails on either arch if the FFmpeg it installed has no libsvtav1.
  • Tests:
    • vapoursynth_integration_test: the macOS x64 exception in libsvtav1 is compiled in is removed, so every bundle must have it.
    • ffmpeg_version_pin_test: reads the build pin, checks it is in the 9.0 series, and requires both SHA-256 pins.
  • app/assets/deps-version.json: points at deps-v1.17.0-rc2.
  • Docs:
    • CLAUDE.md: the AV1 section, the macOS FFmpeg notes and the deps version history.
    • Also updated: README (codec table and acknowledgments), docs/FEATURE_MAP.md (AV1 rows and gaps), BUILDING, NOTICES and ENGINEERING_NOTES.
    • The task-40 report gets a correction card.
    • Worker comments in video_job.rs and pipeline_executor.rs no longer call the gap current.
  • New report: docs/reports/task-45-macos-x64-ffmpeg-svtav1/, with the scripts that produced its numbers.

What changes for Intel Mac users

From the report:

  • The new build targets macOS 12.0, our floor, and links only system frameworks and /usr/lib. It passes check-macho-refs.py and the 9.0 series check.
  • FFmpeg's own encoders (FFV1, ProRes, v210, HuffYUV and the rest) produce byte-identical output.
  • x264, x265 and MP3 streams differ only in the encoder version strings embedded in them, and decode to identical output.
  • All 30 fixtures decode identically, and the HDR tone-map and subtitle burn-in are identical.
  • The components the new build lacks are ones VapourBox doesn't use.
  • Measured under Rosetta. Pre-AVX Macs rely on the encoders' run-time SIMD dispatch, as before.

The availability check (HardwareEncoderDetector, missing_encoder_problem) is kept, for an FFmpeg built without SVT-AV1.

Testing

  • build-deps-macos.yml with arch=both: arm64, x64 v3, x64 v2 and the v2 delta all succeed. That covers the SHA-256 checks, the libsvtav1 check, the series check and check-macho-refs.py.
  • Push gate (ci-test.yml) against the unpublished build, run 43809849835: green on all four platforms. macOS x64 now runs libsvtav1 is compiled in instead of skipping it.
  • deps-v1.17.0-rc2 is published by the three build workflows:
    • all 8 zips, each with a .sha256.json;
    • no full …-x64-v2.zip;
    • a prerelease and not Latest, so 1.7.0 is still Latest.
  • Push gate against the published rc2 (no deps_run_id), run 43813194780: green on Linux, Windows, macOS arm64 and macOS x64.
  • Local: ffmpeg_version_pin_test, av1_test and attribution_test pass (30/30).
  • Not yet run: nightly heavy tests against rc2. AV1 and HDR encodes now run on Intel Macs instead of skipping there. Run nightly.yml before rc2 is promoted to 1.17.0 (task Fix #13: use picture frame rate for field-coded interlaced sources #44).

🤖 Generated with Claude Code

StuartCameronCode and others added 4 commits November 16, 2026 21:06
evermeet's static x64 FFmpeg 9.0.1 has no libsvtav1, so AV1 output was
unavailable on Intel Macs. Take martin-riedl.de's static amd64 release
build instead (9.0.2, the same build run as the arm64 binary): system
frameworks only, minos 12.0, SVT-AV1 v4.2.0. Pinned by build ID and
SHA-256; the host keeps every build-ID URL.

download-deps-macos.sh now fails the build if either arch's FFmpeg lacks
libsvtav1, and the push gate's `libsvtav1 is compiled in` test loses its
macOS x64 exception. Docs, NOTICES and FEATURE_MAP updated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
evermeet 9.0.1 vs martin-riedl 9.0.2 amd64, under Rosetta: minos 12.0,
system frameworks only, series 9.0, SVT-AV1 v4.2.0. Native encoders
byte-identical; x264/x265/MP3 differ only in their version text (decoded
output identical on three fixtures); all 30 fixtures decode identically;
HDR tone-map and burn-in identical. Lost components are unused.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@StuartCameronCode
StuartCameronCode force-pushed the stuart/45-macos-x64-deps-ffmpeg-without-svt-av1-ev branch from 01b8d78 to 4855d18 Compare November 16, 2026 10:06
@StuartCameronCode
StuartCameronCode merged commit 9242b2f into main Nov 16, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant