Repository navigation
Releases
Mac app: player FFmpeg artifact 2026.11.12.1 sources (dynamic framework)
Mac app: FFmpeg artifact 2026.11.12.1
Release tag: macos-ffmpeg-artifact-2026.11.12.1
This folder and its release are the corresponding source for the FFmpeg,
libbluray, libudfread and dav1d code inside the player of Nsuve (formerly
Nsurator) for Mac, in the builds that carry artifact 2026.11.12.1.
Which app builds use it
Mac builds made from the app's source that pins artifact 2026.11.12.1, from
the first build distributed with it (app commit 9311b660, which pinned it with
player core e4e032fe; the version and the build number are added here when it
ships). The app's player core then moved to 49783275 and fdba50b5 with the
same artifact: neither commit changes a patch or a build script, so those builds
load these same libraries. It replaces
artifact 2026.10.09.1, whose release is
macos-ffmpeg-artifact-2026.10.09.1;
builds that pin 2026.10.09.1 or 2026.09.24.1 keep their own releases.
The libraries are in one framework inside the app:
Nsuve.app/Contents/Frameworks/NsuratorPlayerCoreFFmpegRuntime.framework
and two executables load it:
Nsuve.app/Contents/MacOS/NsuveNsuve.app/Contents/XPCServices/NsuveDecoderProbeHelper.xpc/Contents/MacOS/NsuveDecoderProbeHelper
The framework's install name is
@rpath/NsuratorPlayerCoreFFmpegRuntime.framework/Versions/A/NsuratorPlayerCoreFFmpegRuntime.
The app finds it through the rpath @executable_path/../Frameworks (the decoder
helper through @executable_path/../../../../Frameworks), and neither
executable contains a copy of the libraries.
Built from source
Artifact 2026.10.09.1 took the static libraries of 2026.09.24.1 unchanged.
Artifact 2026.11.12.1 does not: it was built from source on 2026-11-12, from the
four upstream archives below and our patches at player core
e4e032fe04f9d64eacf4ba90ffa128e8d028fa31 (15 for FFmpeg and 4 for libbluray,
where 2026.09.24.1 had 7 and 3), by
build/nsurator-macos-native/script/build_nsurator_player_core_ffmpeg_artifact.sh
in the work root /tmp/nsurator-npc-artifact-build-202611121. The artifact
archive, nsurator-player-core-ffmpeg-macosx-arm64-2026.11.12.1.tar.gz
(SHA-256 e3a22a00dd70bb70471aa1986e3246f6f250ffd7df32c7ca93e60e0b1f02f4ef,
pinned by build/nsurator-macos-native/Config/nsurator-player-core-ffmpeg-artifact.lock.json),
holds the framework and the static libraries it was linked from:
| Library | SHA-256 |
|---|---|
install/macosx-arm64/lib/libavcodec.a |
4ae7ef6d7537f8738a514ade875809690abe200a38f8405ad12674d2f2a57519 |
install/macosx-arm64/lib/libavfilter.a |
c310d677bd561189cea49e781cb29071562e293a97cb0f2c64929391175545a8 |
install/macosx-arm64/lib/libavformat.a |
6722ffd722ebb65faa29601661c95f0ea0e7e5c977ad0c91a003c33b81048915 |
install/macosx-arm64/lib/libavutil.a |
33b1e6b5ff2f8a022bef459f42c41a18d468681f7cbed8a72e2bd54a89de4e63 |
install/macosx-arm64/lib/libswresample.a |
55d903558c74e12c7d04690df13155caacc541bf193b6f4a7ed77b17f3aa0207 |
install/macosx-arm64/lib/libswscale.a |
e40601f6140a33f0336d939e8d3f336e06f153b5ce578dac1a564069dd911de7 |
dependencies/macosx-arm64/lib/libbluray.a (contains libudfread) |
efbd861f5ad0021f45a5ffd89b615f09cd4c5288a710046d843de4dd6742f3ab |
dependencies/macosx-arm64/lib/libdav1d.a |
4ba26d9aec7a107107900bcf2c3db169782e90200e7d7cbf436a5506cc398e76 |
Components
| Component | Licence | Upstream archive | SHA-256 | Our changes |
|---|---|---|---|---|
| FFmpeg 8.1.2 | LGPL-2.1-or-later | https://ffmpeg.org/releases/ffmpeg-8.1.2.tar.xz | 464beb5e7bf0c311e68b45ae2f04e9cc2af88851abb4082231742a74d97b524c |
15 patches (11 compiled), see ffmpeg/CHANGES.md |
| libbluray 1.4.1 | LGPL-2.1-or-later | https://code.videolan.org/videolan/libbluray/-/archive/1.4.1/libbluray-1.4.1.tar.gz | e22381a313a231d94ddf9180564b36d803f33bdfc7c0b53c03868bc43e5d163d |
4 patches, see libbluray/CHANGES.md |
| libudfread 1.2.0 | LGPL-2.1-or-later | https://code.videolan.org/videolan/libudfread/-/archive/1.2.0/libudfread-1.2.0.tar.gz | adcce1190925f9d35a477757c5e3f0e221315d14d3d45b4ae62540ea0925f877 |
none |
| dav1d 1.5.3 | BSD-2-Clause | https://code.videolan.org/videolan/dav1d/-/archive/1.5.3/dav1d-1.5.3.tar.gz | cbe212b02faf8c6eed5b6d55ef8a6e363aaab83f15112e960701a9c3df813686 |
none |
The release attaches the exact archives the build used. Their SHA-256 values
match the source lock
(build/nsurator-macos-native/Config/nsurator-player-core-ffmpeg-sources.json),
and they are byte for byte the archives attached to releases 2026.09.24.1 and
2026.10.09.1. The release also attaches our patches with their change notices
(macos-ffmpeg-artifact-2026.11.12.1-patches.tar.gz) and the four source trees
as the build compiled them (macos-ffmpeg-artifact-2026.11.12.1-patched-sources.tar.xz).
Applying ffmpeg/patches/ and libbluray/patches/ in numeric order to the
upstream archives, with libudfread copied into libbluray-1.4.1/contrib/libudfread,
gives exactly those trees (patch may leave .orig copies beside three of the
changed files; they are not part of the trees). release-assets.sha256 lists
every attached file.
Build configuration
- FFmpeg configure line (
records/configure/ffmpeg-macosx-arm64-configure.txt;
the full configure record isffmpeg-macosx-arm64-config.makbeside it):
--enable-cross-compile --target-os=darwin --arch=arm64 --enable-static --disable-shared --enable-pic --disable-programs --disable-doc --disable-debug --disable-avdevice --disable-devices --enable-avcodec --enable-avformat --enable-avutil --enable-swresample --enable-swscale --enable-libbluray --enable-videotoolbox --enable-libdav1d --disable-network,
plus--prefix,--cc,--sysroot,--pkg-configand
-target arm64-apple-macos14.0compiler and linker flags. The line recorded
inrecords/artifact/nsurator-player-core-ffmpeg-apple-manifest.jsonends
with--enable-npc-libbluray; that word is a marker added by our player's
capability report, not an FFmpeg configure option. - Link profile
base. GPL, nonfree and version3 are off (!CONFIG_GPL,
!CONFIG_NONFREE,!CONFIG_VERSION3in the configure record), and the
libraries report "LGPL version 2.1 or later". No network protocol is built. - Toolchain (
records/toolchain.txt): Xcode 27.1 (27A9275) with the MacOSX
27.0 SDK, Apple clang 21.0.0 (clang-2100.3.34.2), ld-27037.1, meson 1.11.2,
ninja 1.13.2, pkg-config 2.5.1; minimum macOS 14.0. - libbluray: meson, static, release; tools, devtools, examples and docs off;
-Dbdj_jar=disabled -Dfreetype=disabled -Dfontconfig=disabled -Dlibxml2=disabled -Dembed_udfread=true -Dforce_fallback_for=libudfread
(records/meson/, with the cross file). - dav1d: meson, static, release; tools, tests, examples and docs off
(records/meson/, with the cross file).
The framework
| Name | NsuratorPlayerCoreFFmpegRuntime.framework (versioned: Versions/A, Versions/Current, no headers; Resources/ holds Info.plist and PrivacyInfo.xcprivacy) |
| Install name | @rpath/NsuratorPlayerCoreFFmpegRuntime.framework/Versions/A/NsuratorPlayerCoreFFmpegRuntime |
| Binary SHA-256 (before signing) | 01331bb2ac2378c3778d7c12b5bbf638229ef3d717340ecc5a2d999af1612f28 (23,586,080 bytes) |
| LC_UUID (signing keeps it) | F1E2242D-967C-3D9C-B2D4-76E74F0F2D8C |
| Architecture, minimum macOS | arm64, 14.0 |
| Exports | 7,349 symbols |
| Dependencies | system frameworks and libraries only (AppKit, AudioToolbox, CoreFoundation, CoreGraphics, CoreImage, CoreMedia, CoreServices, CoreVideo, DiskArbitration, Foundation, OpenGL, VideoToolbox, libSystem, libbz2, libiconv, libobjc, libz) |
The App Store copy of the binary differs from the SHA-256 above only by its
code signature; compare the UUID (dwarfdump --uuid) instead.
records/framework/FRAMEWORK-RECORD.json has the exact link command (with
paths relative to the artifact), the checksum of every input archive, the
checksum of the exported symbol list, and the compiler and linker versions.
Folder contents
| Path | What it is |
|---|---|
ffmpeg/patches/, libbluray/patches/ |
Our patches, numbered in the order they are applied |
ffmpeg/CHANGES.md, libbluray/CHANGES.md |
Dated change notices, and which changes are compiled |
libudfread/, dav1d/ |
Licences and source notes (no changes) |
*/COPYING*, ffmpeg/LICENSE.md |
Licence texts taken from the upstream sources |
build/nsurator-player-core-e4e032f/scripts/ |
The player core's scripts at commit e4e032fe04f9d64eacf4ba90ffa128e8d028fa31, which built the libraries and the framework: build-ffmpeg-apple.sh and build-ffmpeg-visionos.sh (dav1d, libbluray and FFmpeg, and --package-artifact-root), apply-ffmpeg-source-patches.sh, package-apple-ffmpeg-runtime-framework.sh (the framework) and assemble-ffmpeg-artifact-release-packet.py. patches/ holds the 15 FFmpeg and 4 libbluray patches under the names the scripts use; the core's DVD-library patches, which this build does not use, are left out |
build/nsurator-macos-native/ |
The Mac app repository's artifact build script, its helpers and the two locks that pin this artifact |
records/artifact/ |
Records shipped inside the artifact, in its own layout: provenance (a copy of the source lock), manifest, and distribution/ (source offer, attribution, relinking notes, relink-materials manifest) |
records/framework/ |
FRAMEWORK-RECORD.json |
records/configure/, records/meson/, records/toolchain.txt |
FFmpeg's configure line and config.mak, the meson options and cross files of dav1d and libbluray, and the tool versions |
release-assets.sha256 |
SHA-256 of every file attached to the release |
Rebuilding the libraries
You need a Mac with Xcode (the artifact used Xcode 27.1 and the MacOSX 27.0
SDK), meson, ninja and pkg-config.
build/nsurator-macos-native/script/build_nsurator_player_core_ffmpeg_artifact.sh
is the script that built ...
Apple Vision Pro app: FFmpeg libraries 2026.11.12 sources (static)
Apple Vision Pro app: FFmpeg libraries built 2026-11-12 (static)
Release tag: visionos-ffmpeg-static-2026.11.12-10903474
This folder and its release are the corresponding source for the FFmpeg,
libbluray, libudfread and dav1d code inside Nsuve for Apple Vision Pro.
Which app builds use it
Nsuve for Apple Vision Pro, from its first distributed build. No build has been
distributed yet; the version and build number are added here when one ships.
The app's source pins the recipe in build/nsurator-visionos-native/ from commit
8f708bf on, and its builds link the libraries that recipe made on
2026-11-12.
This release replaces visionos-ffmpeg-static-2026.11.11-e9f11afc, which no distributed build used. It has
the same upstream archives, configure options and 17 patches, and two more
FFmpeg patches from the app's player core: a seek in a Matroska file goes
straight to the block its cue names (0014), and an option leaves a font
attachment's data unread while a file opens (0015; the app does not turn it
on). See records/PROVENANCE.md.
The libraries are linked statically into the app's executable,
NsuratorVision.app/NsuratorVision (the app is named Nsuve on the device): the
eight static libraries libavformat, libavcodec, libavutil, libavfilter,
libswresample, libswscale, libbluray (which contains libudfread) and
libdav1d, for arm64 visionOS devices (xros-arm64). Their SHA-256 values are
in records/static-libraries-xros-arm64.sha256; the tag ends with the first
eight digits of that file's own SHA-256. The same recipe also builds a simulator
slice (xrsimulator-arm64), which is used only for development and is never
distributed.
The app's SMB support, AMSMB2 and libsmb2, is a separate dynamic framework
(AMSMB2.framework) built from the same sources and patches as the iPhone's,
byte for byte: see the release ios-1.0.1-amsmb2-4.0.3-libsmb2-aff9fa6.
Components
| Component | Licence | Upstream archive (attached unchanged) | SHA-256 | Our changes |
|---|---|---|---|---|
| FFmpeg 8.1.2 | LGPL-2.1-or-later | https://ffmpeg.org/releases/ffmpeg-8.1.2.tar.xz | 464beb5e7bf0c311e68b45ae2f04e9cc2af88851abb4082231742a74d97b524c |
15 patches, see ffmpeg/CHANGES.md |
| libbluray 1.4.1 | LGPL-2.1-or-later | https://code.videolan.org/videolan/libbluray/-/archive/1.4.1/libbluray-1.4.1.tar.gz | e22381a313a231d94ddf9180564b36d803f33bdfc7c0b53c03868bc43e5d163d |
4 patches, see libbluray/CHANGES.md |
| libudfread 1.2.0 | LGPL-2.1-or-later | https://code.videolan.org/videolan/libudfread/-/archive/1.2.0/libudfread-1.2.0.tar.gz | adcce1190925f9d35a477757c5e3f0e221315d14d3d45b4ae62540ea0925f877 |
none |
| dav1d 1.5.3 | BSD-2-Clause | https://code.videolan.org/videolan/dav1d/-/archive/1.5.3/dav1d-1.5.3.tar.gz | cbe212b02faf8c6eed5b6d55ef8a6e363aaab83f15112e960701a9c3df813686 |
none |
These are the same upstream archives as the iPhone/iPad and Mac releases.
Eighteen of the nineteen patches are, byte for byte, the ones of the same names
in ios-ffmpeg-runtime-2026.11.09.1-6e09d2b2; the nineteenth,
ffmpeg-videotoolbox-visionos.patch, is new for visionOS: it makes FFmpeg's
VideoToolbox code build and work there.
Build configuration
- Recipe:
build/nsurator-visionos-native/scripts/build_ffmpeg_visionos.sh, with
the source lockscripts/ffmpeg/sources.lock.jsonand the patch series
scripts/ffmpeg/patches/seriesnext to it (the app repository's files at
commit8f708bf). - FFmpeg configure line:
records/configure/ffmpeg-xros-arm64-configure.txt
(full record:ffmpeg-xros-arm64-config.mak). Thebaselink profile,
static:--enable-static --disable-shared --enable-pic --disable-programs --disable-doc --disable-debug --disable-avdevice --disable-devices --enable-avcodec --enable-avformat --enable-avutil --enable-swresample --enable-swscale --enable-libbluray --enable-videotoolbox --enable-libdav1d --disable-network, plus--enable-cross-compile --target-os=darwin --arch=arm64 --cc=clang --pkg-config=pkg-configand
-target arm64-apple-xros27.0compiler and linker flags. The line names no
directory:configureruns through the relative linksrc/, the SDK comes
fromSDKROOT, and the install prefix is given tomake install. GPL,
nonfree and version3 are off (!CONFIG_GPL,!CONFIG_NONFREE,
!CONFIG_VERSION3in the record); the libraries report "LGPL version 2.1 or
later". No network protocol and no TLS is compiled: the app reads files
through its own I/O. - In the meson records and
config.mak,$WORKstands for the build's work
directory and$TOOLINGfor the Python environment that held meson, ninja and
pkg-config. - libbluray: meson, static, release; tools, devtools, examples and docs off;
-Dbdj_jar=disabled -Dfreetype=disabled -Dfontconfig=disabled -Dlibxml2=disabled -Dembed_udfread=true -Dforce_fallback_for=libudfread
(records/meson/). - dav1d: meson, static, release; tools, tests, examples and docs off.
- Toolchain:
records/toolchain.txtandrecords/BUILD-INFO-xros-arm64.txt
(Xcode 27.1, visionOS 27.0 SDK, Apple clang 21.0.0 (clang-2100.3.34.2),
targetarm64-apple-xros27.0; meson 1.12.1, ninja 1.13.2, pkgconf 3.0.7).
Folder contents
| Path | What it is |
|---|---|
ffmpeg/patches/, libbluray/patches/ |
Our patches, numbered in the order they are applied |
ffmpeg/CHANGES.md, libbluray/CHANGES.md |
Dated change notices |
libudfread/, dav1d/ |
Licences and source notes (no changes) |
*/COPYING*, ffmpeg/LICENSE.md |
Licence texts taken from the upstream sources |
build/nsurator-visionos-native/scripts/ |
The app repository's build script, source lock, probe program and patch series, in its layout |
records/ |
The configure and meson records, the toolchain, the eight libraries' SHA-256 values and how they were checked (PROVENANCE.md) |
release-assets.sha256 |
SHA-256 of every file attached to the release |
Rebuilding the libraries
You need a Mac with Xcode (these libraries were built with Xcode 27.1 and its
visionOS 27.0 SDK), meson, ninja, pkg-config and python3. The directory must not
contain spaces.
mkdir /absolute/path/without/spaces && cd /absolute/path/without/spaces
tar -xzf /path/to/visionos-ffmpeg-static-2026.11.12-10903474-build-scripts-and-records.tar.gz --strip-components=1
mkdir archives
cp /path/to/ffmpeg-8.1.2.tar.xz /path/to/libbluray-1.4.1.tar.gz \
/path/to/libudfread-1.2.0.tar.gz /path/to/dav1d-1.5.3.tar.gz archives/
NV_FFMPEG_ARCHIVES="$PWD/archives" NV_FFMPEG_SLICES=xros-arm64 \
build/nsurator-visionos-native/scripts/build_ffmpeg_visionos.shThe script checks every archive's SHA-256 against the lock, unpacks them,
copies libudfread into libbluray's contrib/libudfread, applies the patches in
the order of series, builds dav1d, libbluray and FFmpeg, and links a small
probe program (scripts/ffmpeg/probe.c) against the result. It finds meson,
ninja and pkg-config in the directory NV_FFMPEG_TOOLING names, or on PATH.
The static libraries end up in
build/nsurator-visionos-native/artifacts/ffmpeg/xros-arm64/lib. It never
downloads anything. Two steps of its check need our other repositories or a
running simulator and are skipped without them: the link check of our player's
FFmpeg shim, and running the probe in a booted visionOS simulator.
With the same Xcode, the six FFmpeg libraries come out byte for byte the ones
the app links, whichever directory you build in. In libdav1d.a and
libbluray.a every member does too; those two archives differ only in the
dates and owner ids in their member headers (see below).
visionos-ffmpeg-static-2026.11.12-10903474-patched-sources.tar.xz holds the four trees after patching
(sources/ffmpeg-8.1.2, sources/libbluray-1.4.1 with libudfread in
contrib/libudfread, sources/libudfread-1.2.0, sources/dav1d-1.5.3), for
reading or for building by hand with the commands in the records.
Replacing the libraries in the app
The app links these libraries statically. To use modified libraries, the app's
executable must be linked again with them, which needs the app's own object
files. This repository does not contain them. In the app, Settings › About ›
Open-Source Licenses › Source Code and Relinking Materials (设置 › 关于 › 开源许可 ›
源代码和重新链接材料) says how to ask for the materials needed to relink; see also
https://www.nsurator.com/support.html#oss.
What visionOS allows: like iOS, it runs only code signed by Apple or by a
developer certificate whose provisioning profile includes the device. Copies of
the app installed from the App Store are encrypted and signed by Apple, so a
relinked executable runs only in a copy of the app that you sign and install
yourself.
What we could not pin
- The archives
libdav1d.aandlibbluray.aare made by meson'sar, which
writes each member's build date and the builder's user and group ids into
the archive. Their SHA-256 values therefore change in every rebuild, although
every member stays byte for byte the same (checked again for this build). To
compare them, unpack them (ar -x) and compare the members. libdav1d.awas compiled on 2026-10-20 with Xcode 27.0; rebuilds with
Xcode 27.1 give the same members. Inlibbluray.athe members of the files
our patches change were compiled again for this build (the build unpacks and
patches the sources afresh when the patch set changes).
中文说明
本目录和同名 Release 是 Nsuve Apple Vision Pro 版中 FFmpeg 8.1.2、
libbluray 1.4.1、libudfread 1.2.0、dav1d 1.5.3 的对应源码。
- 适用版本:Apple Vision Pro 版从第一个对外发布的构建起使用这套库;目前还没有对外
发布过,发布时在这里补上版本号和构建号。应用源码从提交8f708bf起固定使用
build/nsurator-visionos-native/里的构建配方,链接这套配方 2026-11-12 构建出的库。 - 本 Release 取代
visionos-ffmpeg-static-2026.11.11-e9f11afc(那一版没有被任何对外发布的构建用过):上游源码包、
配置参数和原有的 17 个补丁都相同,另外加了播放内核的两个 FFmpeg 补丁:Matroska
文件跳转时直接读索引(cue)指向的那一块(0014);打开文件时可以不读字体附件的数据
(0015,应用没有打开这个选项)。详见records/PROVENANCE.md。 - 这些库静态链接进应用主程序 `Nsurato...
Apple Vision Pro app: FFmpeg libraries 2026.11.11 sources (static), replaced by 2026.11.12, never shipped
Apple Vision Pro app: FFmpeg libraries built 2026-11-11 (static)
Replaced on 2026-11-12 by
visionos-ffmpeg-static-2026.11.12-10903474,
before any build of the app was distributed. No app build uses this release.
That release has the same upstream archives, configure options and 17 patches,
and two more FFmpeg patches from the app's player core (a Matroska seek goes
straight to the block its cue names; an option leaves a font attachment's data
unread). Apart from this note, this folder and the release's assets are as
published on 2026-11-11.2026-11-12 已由
visionos-ffmpeg-static-2026.11.12-10903474取代。 当时应用还没有任何构建对外发布,
没有任何应用版本使用本 Release。新版的上游源码包、配置参数和原有的 17 个补丁都相同,
另外加了播放内核的两个 FFmpeg 补丁(Matroska 跳转直接读索引指向的那一块;打开文件时
可以不读字体附件的数据)。除这段说明外,本目录和 Release 的附件保持 2026-11-11 发布时的样子。
Release tag: visionos-ffmpeg-static-2026.11.11-e9f11afc
This folder and its release are the corresponding source for the FFmpeg,
libbluray, libudfread and dav1d code inside Nsuve for Apple Vision Pro.
Which app builds use it
Nsuve for Apple Vision Pro, from its first distributed build. No build has been
distributed yet; the version and build number are added here when one ships.
The app's source pins the recipe in build/nsurator-visionos-native/ from commit
6355d40 (2026-11-11) on, and its builds link the libraries that recipe
made on 2026-11-11.
This release replaces visionos-ffmpeg-static-2026.10.20-5d1d94b7, which no distributed build used. The
sources, patches and configure options are the same; those libraries had the
build's directory paths compiled into them, and these have none (see
records/PROVENANCE.md).
The libraries are linked statically into the app's executable,
NsuratorVision.app/NsuratorVision (the app is named Nsuve on the device): the
eight static libraries libavformat, libavcodec, libavutil, libavfilter,
libswresample, libswscale, libbluray (which contains libudfread) and
libdav1d, for arm64 visionOS devices (xros-arm64). Their SHA-256 values are
in records/static-libraries-xros-arm64.sha256; the tag ends with the first
eight digits of that file's own SHA-256. The same recipe also builds a simulator
slice (xrsimulator-arm64), which is used only for development and is never
distributed.
The app's SMB support, AMSMB2 and libsmb2, is a separate dynamic framework
(AMSMB2.framework) built from the same sources and patches as the iPhone's,
byte for byte: see the release ios-1.0.1-amsmb2-4.0.3-libsmb2-aff9fa6.
Components
| Component | Licence | Upstream archive (attached unchanged) | SHA-256 | Our changes |
|---|---|---|---|---|
| FFmpeg 8.1.2 | LGPL-2.1-or-later | https://ffmpeg.org/releases/ffmpeg-8.1.2.tar.xz | 464beb5e7bf0c311e68b45ae2f04e9cc2af88851abb4082231742a74d97b524c |
13 patches, see ffmpeg/CHANGES.md |
| libbluray 1.4.1 | LGPL-2.1-or-later | https://code.videolan.org/videolan/libbluray/-/archive/1.4.1/libbluray-1.4.1.tar.gz | e22381a313a231d94ddf9180564b36d803f33bdfc7c0b53c03868bc43e5d163d |
4 patches, see libbluray/CHANGES.md |
| libudfread 1.2.0 | LGPL-2.1-or-later | https://code.videolan.org/videolan/libudfread/-/archive/1.2.0/libudfread-1.2.0.tar.gz | adcce1190925f9d35a477757c5e3f0e221315d14d3d45b4ae62540ea0925f877 |
none |
| dav1d 1.5.3 | BSD-2-Clause | https://code.videolan.org/videolan/dav1d/-/archive/1.5.3/dav1d-1.5.3.tar.gz | cbe212b02faf8c6eed5b6d55ef8a6e363aaab83f15112e960701a9c3df813686 |
none |
These are the same upstream archives as the iPhone/iPad and Mac releases. Sixteen
of the seventeen patches are, byte for byte, the ones of the same names in
ios-ffmpeg-runtime-2026.11.09.1-6e09d2b2; the seventeenth,
ffmpeg-videotoolbox-visionos.patch, is new for visionOS: it makes FFmpeg's
VideoToolbox code build and work there.
Build configuration
- Recipe:
build/nsurator-visionos-native/scripts/build_ffmpeg_visionos.sh, with
the source lockscripts/ffmpeg/sources.lock.jsonand the patch series
scripts/ffmpeg/patches/seriesnext to it (the app repository's files at
commit6355d40). - FFmpeg configure line:
records/configure/ffmpeg-xros-arm64-configure.txt
(full record:ffmpeg-xros-arm64-config.mak). Thebaselink profile,
static:--enable-static --disable-shared --enable-pic --disable-programs --disable-doc --disable-debug --disable-avdevice --disable-devices --enable-avcodec --enable-avformat --enable-avutil --enable-swresample --enable-swscale --enable-libbluray --enable-videotoolbox --enable-libdav1d --disable-network, plus--enable-cross-compile --target-os=darwin --arch=arm64 --cc=clang --pkg-config=pkg-configand
-target arm64-apple-xros27.0compiler and linker flags. The line names no
directory:configureruns through the relative linksrc/, the SDK comes
fromSDKROOT, and the install prefix is given tomake install. GPL,
nonfree and version3 are off (!CONFIG_GPL,!CONFIG_NONFREE,
!CONFIG_VERSION3in the record); the libraries report "LGPL version 2.1 or
later". No network protocol and no TLS is compiled: the app reads files
through its own I/O. - In the meson records and
config.mak,$WORKstands for the build's work
directory and$TOOLINGfor the Python environment that held meson, ninja and
pkg-config. - libbluray: meson, static, release; tools, devtools, examples and docs off;
-Dbdj_jar=disabled -Dfreetype=disabled -Dfontconfig=disabled -Dlibxml2=disabled -Dembed_udfread=true -Dforce_fallback_for=libudfread
(records/meson/). - dav1d: meson, static, release; tools, tests, examples and docs off.
- Toolchain:
records/toolchain.txtandrecords/BUILD-INFO-xros-arm64.txt
(FFmpeg: Xcode 27.1, visionOS 27.0 SDK, Apple clang 21.0.0
(clang-2100.3.34.2), targetarm64-apple-xros27.0; meson 1.12.1, ninja
1.13.2, pkgconf 3.0.7).
Folder contents
| Path | What it is |
|---|---|
ffmpeg/patches/, libbluray/patches/ |
Our patches, numbered in the order they are applied |
ffmpeg/CHANGES.md, libbluray/CHANGES.md |
Dated change notices |
libudfread/, dav1d/ |
Licences and source notes (no changes) |
*/COPYING*, ffmpeg/LICENSE.md |
Licence texts taken from the upstream sources |
build/nsurator-visionos-native/scripts/ |
The app repository's build script, source lock, probe program and patch series, in its layout |
records/ |
The configure and meson records, the toolchain, the eight libraries' SHA-256 values and how they were checked (PROVENANCE.md) |
release-assets.sha256 |
SHA-256 of every file attached to the release |
Rebuilding the libraries
You need a Mac with Xcode (these libraries were built with Xcode 27.1 and its
visionOS 27.0 SDK), meson, ninja, pkg-config and python3. The directory must not
contain spaces.
mkdir /absolute/path/without/spaces && cd /absolute/path/without/spaces
tar -xzf /path/to/visionos-ffmpeg-static-2026.11.11-e9f11afc-build-scripts-and-records.tar.gz --strip-components=1
mkdir archives
cp /path/to/ffmpeg-8.1.2.tar.xz /path/to/libbluray-1.4.1.tar.gz \
/path/to/libudfread-1.2.0.tar.gz /path/to/dav1d-1.5.3.tar.gz archives/
NV_FFMPEG_ARCHIVES="$PWD/archives" NV_FFMPEG_SLICES=xros-arm64 \
build/nsurator-visionos-native/scripts/build_ffmpeg_visionos.shThe script checks every archive's SHA-256 against the lock, unpacks them,
copies libudfread into libbluray's contrib/libudfread, applies the patches in
the order of series, builds dav1d, libbluray and FFmpeg, and links a small
probe program (scripts/ffmpeg/probe.c) against the result. It finds meson,
ninja and pkg-config in the directory NV_FFMPEG_TOOLING names, or on PATH.
The static libraries end up in
build/nsurator-visionos-native/artifacts/ffmpeg/xros-arm64/lib. It never
downloads anything. Two steps of its check need our other repositories or a
running simulator and are skipped without them: the link check of our player's
FFmpeg shim, and running the probe in a booted visionOS simulator.
With the same Xcode, the six FFmpeg libraries come out byte for byte the ones
the app links, whichever directory you build in. In libdav1d.a and
libbluray.a every member does too; those two archives differ only in the
dates and owner ids in their member headers (see below).
visionos-ffmpeg-static-2026.11.11-e9f11afc-patched-sources.tar.xz holds the four trees after patching
(sources/ffmpeg-8.1.2, sources/libbluray-1.4.1 with libudfread in
contrib/libudfread, sources/libudfread-1.2.0, sources/dav1d-1.5.3), for
reading or for building by hand with the commands in the records.
Replacing the libraries in the app
The app links these libraries statically. To use modified libraries, the app's
executable must be linked again with them, which needs the app's own object
files. This repository does not contain them. In the app, Settings › About ›
Open-Source Licenses › Source Code and Relinking Materials (设置 › 关于 › 开源许可 ›
源代码和重新链接材料) says how to ask for the materials needed to relink; see also
https://www.nsurator.com/support.html#oss.
What visionOS allows: like iOS, it runs only code signed by Apple or by a
developer certificate whose provisioning profile includes the device. Copies of
the app installed from the App Store are encrypted and signed by Apple, so a
relinked executable runs only in a copy of the app that you sign and install
yourself.
What we could not pin
- The archives
libdav1d.aandlibbluray.aare made by meson'sar, which
writes each member's build date and the builder's user and group ids into
the archive.
Their SHA-256 values therefore change in every rebuild, although every member
stays byte for byte the same (checked 2026-11-11 for all 72 and 60 members).
To compare them, unpack them (ar -x) and compare the memb...
Apple Vision Pro app: FFmpeg libraries 2026.10.20 sources (static), replaced by 2026.11.11, never shipped
Apple Vision Pro app: FFmpeg libraries built 2026-10-20 (static)
Replaced on 2026-11-11 by
visionos-ffmpeg-static-2026.11.11-e9f11afc,
before any build of the app was distributed. No app build uses this release.
The sources, patches and configure options are the same. These libraries had
the build's directory paths compiled into them; that release's libraries have
none. Apart from this note, this folder and the release's assets are as
published on 2026-11-10.2026-11-11 已由
visionos-ffmpeg-static-2026.11.11-e9f11afc取代。 当时应用还没有任何构建对外发布,
没有任何应用版本使用本 Release。源码、补丁和配置参数相同;这一版的库里编进了构建
机器上的目录路径,新版没有。除这段说明外,本目录和 Release 的附件保持 2026-11-10
发布时的样子。
Release tag: visionos-ffmpeg-static-2026.10.20-5d1d94b7
This folder and its release are the corresponding source for the FFmpeg,
libbluray, libudfread and dav1d code inside Nsuve for Apple Vision Pro.
Which app builds use it
Nsuve for Apple Vision Pro, from its first distributed build. No build has been
distributed yet; the version and build number are added here when one ships.
The app's source pins the recipe in build/nsurator-visionos-native/ from commit
17351ea (2026-10-21) on, unchanged at commit d81c336 (2026-11-10),
and its builds link the libraries that recipe made on 2026-10-20.
The libraries are linked statically into the app's executable,
NsuratorVision.app/NsuratorVision (the app is named Nsuve on the device): the
eight static libraries libavformat, libavcodec, libavutil, libavfilter,
libswresample, libswscale, libbluray (which contains libudfread) and
libdav1d, for arm64 visionOS devices (xros-arm64). Their SHA-256 values are
in records/static-libraries-xros-arm64.sha256; the tag ends with the first
eight digits of that file's own SHA-256. The same recipe also builds a simulator
slice (xrsimulator-arm64), which is used only for development and is never
distributed.
The app's SMB support, AMSMB2 and libsmb2, is a separate dynamic framework
(AMSMB2.framework) built from the same sources and patches as the iPhone's,
byte for byte: see the release ios-1.0.1-amsmb2-4.0.3-libsmb2-aff9fa6.
Components
| Component | Licence | Upstream archive (attached unchanged) | SHA-256 | Our changes |
|---|---|---|---|---|
| FFmpeg 8.1.2 | LGPL-2.1-or-later | https://ffmpeg.org/releases/ffmpeg-8.1.2.tar.xz | 464beb5e7bf0c311e68b45ae2f04e9cc2af88851abb4082231742a74d97b524c |
13 patches, see ffmpeg/CHANGES.md |
| libbluray 1.4.1 | LGPL-2.1-or-later | https://code.videolan.org/videolan/libbluray/-/archive/1.4.1/libbluray-1.4.1.tar.gz | e22381a313a231d94ddf9180564b36d803f33bdfc7c0b53c03868bc43e5d163d |
4 patches, see libbluray/CHANGES.md |
| libudfread 1.2.0 | LGPL-2.1-or-later | https://code.videolan.org/videolan/libudfread/-/archive/1.2.0/libudfread-1.2.0.tar.gz | adcce1190925f9d35a477757c5e3f0e221315d14d3d45b4ae62540ea0925f877 |
none |
| dav1d 1.5.3 | BSD-2-Clause | https://code.videolan.org/videolan/dav1d/-/archive/1.5.3/dav1d-1.5.3.tar.gz | cbe212b02faf8c6eed5b6d55ef8a6e363aaab83f15112e960701a9c3df813686 |
none |
These are the same upstream archives as the iPhone/iPad and Mac releases. Sixteen
of the seventeen patches are, byte for byte, the ones of the same names in
ios-ffmpeg-runtime-2026.11.09.1-6e09d2b2; the seventeenth,
ffmpeg-videotoolbox-visionos.patch, is new here: it makes FFmpeg's VideoToolbox
code build and work on visionOS.
Build configuration
- Recipe:
build/nsurator-visionos-native/scripts/build_ffmpeg_visionos.sh, with
the source lockscripts/ffmpeg/sources.lock.jsonand the patch series
scripts/ffmpeg/patches/seriesnext to it (the app repository's files,
unchanged since commit17351ea). - FFmpeg configure line:
records/configure/ffmpeg-xros-arm64-configure.txt
(full record:ffmpeg-xros-arm64-config.mak). Thebaselink profile,
static:--enable-static --disable-shared --enable-pic --disable-programs --disable-doc --disable-debug --disable-avdevice --disable-devices --enable-avcodec --enable-avformat --enable-avutil --enable-swresample --enable-swscale --enable-libbluray --enable-videotoolbox --enable-libdav1d --disable-network, plus--prefix,--cc,--sysroot,--pkg-configand
-target arm64-apple-xros27.0compiler and linker flags. GPL, nonfree and
version3 are off (!CONFIG_GPL,!CONFIG_NONFREE,!CONFIG_VERSION3in the
record); the libraries report "LGPL version 2.1 or later". No network protocol
and no TLS is compiled: the app reads files through its own I/O. - In the records,
$WORKstands for the build's work directory and$TOOLING
for the Python environment that held meson, ninja and pkg-config. - libbluray: meson, static, release; tools, devtools, examples and docs off;
-Dbdj_jar=disabled -Dfreetype=disabled -Dfontconfig=disabled -Dlibxml2=disabled -Dembed_udfread=true -Dforce_fallback_for=libudfread
(records/meson/). - dav1d: meson, static, release; tools, tests, examples and docs off.
- Toolchain: Xcode 27.0 (27A266a), visionOS 27.0 SDK, Apple clang 21.0.0
(clang-2100.3.34.2), targetarm64-apple-xros27.0; meson 1.12.1, ninja
1.13.2 (records/toolchain.txt,records/BUILD-INFO-xros-arm64.txt).
Folder contents
| Path | What it is |
|---|---|
ffmpeg/patches/, libbluray/patches/ |
Our patches, numbered in the order they are applied |
ffmpeg/CHANGES.md, libbluray/CHANGES.md |
Dated change notices |
libudfread/, dav1d/ |
Licences and source notes (no changes) |
*/COPYING*, ffmpeg/LICENSE.md |
Licence texts taken from the upstream sources |
build/nsurator-visionos-native/scripts/ |
The app repository's build script, source lock, probe program and patch series, in its layout |
records/ |
The configure and meson records, the toolchain, the eight libraries' SHA-256 values and how they were checked (PROVENANCE.md) |
release-assets.sha256 |
SHA-256 of every file attached to the release |
Rebuilding the libraries
You need a Mac with Xcode (the libraries were built with Xcode 27.0 and its
visionOS 27.0 SDK), meson, ninja, pkg-config and python3. The directory must not
contain spaces.
mkdir /absolute/path/without/spaces && cd /absolute/path/without/spaces
tar -xzf /path/to/visionos-ffmpeg-static-2026.10.20-5d1d94b7-build-scripts-and-records.tar.gz --strip-components=1
mkdir archives
cp /path/to/ffmpeg-8.1.2.tar.xz /path/to/libbluray-1.4.1.tar.gz \
/path/to/libudfread-1.2.0.tar.gz /path/to/dav1d-1.5.3.tar.gz archives/
NV_FFMPEG_ARCHIVES="$PWD/archives" NV_FFMPEG_SLICES=xros-arm64 \
build/nsurator-visionos-native/scripts/build_ffmpeg_visionos.shThe script checks every archive's SHA-256 against the lock, unpacks them,
copies libudfread into libbluray's contrib/libudfread, applies the patches in
the order of series, builds dav1d, libbluray and FFmpeg, and links a small
probe program (scripts/ffmpeg/probe.c) against the result. It finds meson,
ninja and pkg-config in the directory NV_FFMPEG_TOOLING names, or on PATH.
The static libraries end up in
build/nsurator-visionos-native/artifacts/ffmpeg/xros-arm64/lib. It never
downloads anything. Two steps of its check need our other repositories or a
running simulator and are skipped without them: the link check of our player's
FFmpeg shim, and running the probe in a booted visionOS simulator.
visionos-ffmpeg-static-2026.10.20-5d1d94b7-patched-sources.tar.xz holds the four trees after patching
(sources/ffmpeg-8.1.2, sources/libbluray-1.4.1 with libudfread in
contrib/libudfread, sources/libudfread-1.2.0, sources/dav1d-1.5.3), for
reading or for building by hand with the commands in the records.
Replacing the libraries in the app
The app links these libraries statically. To use modified libraries, the app's
executable must be linked again with them, which needs the app's own object
files. This repository does not contain them. In the app, Settings › About ›
Open-Source Licenses › Source Code and Relinking Materials (设置 › 关于 › 开源许可 ›
源代码和重新链接材料) says how to ask for the materials needed to relink; see also
https://www.nsurator.com/support.html#oss.
What visionOS allows: like iOS, it runs only code signed by Apple or by a
developer certificate whose provisioning profile includes the device. Copies of
the app installed from the App Store are encrypted and signed by Apple, so a
relinked executable runs only in a copy of the app that you sign and install
yourself.
What we could not pin
- The libraries do not rebuild byte for byte. Rebuilt on 2026-11-10 from this
release's files with the commands above, in another directory (Xcode 27.1,
visionOS 27.0 SDK), the build and its checks passed, but all eight libraries
differ from the shipped ones, at least in the build paths compiled into them
(FFmpeg also keeps its configure line, with those paths, inlibavutil).
What was checked instead is inrecords/PROVENANCE.md: the patched trees
equal, file for file, the trees the shipped libraries were built from, and
the app was linked with libraries of exactly the SHA-256 values in the
records. - The build did not log pkg-config's version.
中文说明
本目录和同名 Release 是 Nsuve Apple Vision Pro 版中 FFmpeg 8.1.2、
libbluray 1.4.1、libudfread 1.2.0、dav1d 1.5.3 的对应源码。
- 适用版本:Apple Vision Pro 版从第一个对外发布的构建起使用这套库;目前还没有对外
发布过,发布时在这里补上版本号和构建号。应用源码从提交17351ea(2026-10-21)
起固定使用build/nsurator-visionos-native/里的构建配方,到d81c336(2026-11-10)
没有变,构建时链接的是这套配方 2026-10-20 构建出的库。 - 这些库静态链接进应用主程序
NsuratorVision.app/NsuratorVision(在设备上叫
Nsuve),共 8 个静态库,SHA-256 见records/static-libraries-xros-arm64.sha256;
标签末尾的 8 位就是这个文件自身 SHA-256 的前 8 位。模拟器切片只用于开发,从不对外发布。 - 我们改过 FFmpeg(13 个补丁)和 libbluray(4 个补丁),修改说明和日期见
ffmpeg/CHANGES.md、libbluray/CHANGES.md。...
iPhone/iPad app: FFmpeg runtime 2026.11.09.1 sources
iPhone and iPad app: FFmpeg runtime 2026.11.09.1
Release tag: ios-ffmpeg-runtime-2026.11.09.1-6e09d2b2
This folder and its release are the corresponding source for
NsuratorPlayerCoreFFmpegRuntime.framework, the media library framework inside
Nsuve (formerly Nsurator) for iPhone and iPad from the first build distributed
with it (app commit 576834c8; the version and build number are added here when
it ships). It replaces runtime 2026.11.08.2 (release
ios-ffmpeg-runtime-2026.11.08.2-37fd490c): the same sources and recipe, one
more FFmpeg patch (the Matroska demuxer's skip_attachment_data option,
ffmpeg/CHANGES.md 0015), built with Xcode 27.1.
The shipped binary
| Path in the app | NsuratorPhone.app/Frameworks/NsuratorPlayerCoreFFmpegRuntime.framework/NsuratorPlayerCoreFFmpegRuntime |
| Linking | Dynamic framework (shallow iOS bundle, no headers). Install name @rpath/NsuratorPlayerCoreFFmpegRuntime.framework/NsuratorPlayerCoreFFmpegRuntime, compatibility version 1.0.0. The app finds it through @executable_path/Frameworks. |
| Device slice (ios-arm64) SHA-256, before signing | 6e09d2b2315294d9ffcabcf5a84743cd64b9f67cf1d99608bc1787c97b0c1586 (LC_UUID 20610643-378B-3444-91F4-79C108D84779, 22,989,456 bytes) |
| Simulator slice (ios-arm64-simulator) SHA-256 | c31188df91eb2e029aac433dc2920e55228fe284cad9f0f8977a5dd6361de833 (LC_UUID 80BA54C4-2C6F-3C0D-A86C-D88B17B2AA57) |
| Pinned by | build/nsurator-iphone-native/scripts/ios-ffmpeg-runtime-lock.json |
| Contains | FFmpeg (libavformat, libavcodec, libavfilter, libavutil, libswresample, libswscale), libbluray with libudfread, and dav1d. No app code. |
The App Store copy differs from the SHA-256 above only by its code signature;
compare the UUID (dwarfdump --uuid) instead.
Components
| Component | Licence | Upstream archive (attached unchanged) | SHA-256 | Our changes |
|---|---|---|---|---|
| FFmpeg 8.1.2 | LGPL-2.1-or-later | https://ffmpeg.org/releases/ffmpeg-8.1.2.tar.xz | 464beb5e7bf0c311e68b45ae2f04e9cc2af88851abb4082231742a74d97b524c |
15 patches, see ffmpeg/CHANGES.md |
| libbluray 1.4.1 | LGPL-2.1-or-later | https://code.videolan.org/videolan/libbluray/-/archive/1.4.1/libbluray-1.4.1.tar.gz | e22381a313a231d94ddf9180564b36d803f33bdfc7c0b53c03868bc43e5d163d |
4 patches, see libbluray/CHANGES.md |
| libudfread 1.2.0 | LGPL-2.1-or-later | https://code.videolan.org/videolan/libudfread/-/archive/1.2.0/libudfread-1.2.0.tar.gz | adcce1190925f9d35a477757c5e3f0e221315d14d3d45b4ae62540ea0925f877 |
none |
| dav1d 1.5.3 | BSD-2-Clause | https://code.videolan.org/videolan/dav1d/-/archive/1.5.3/dav1d-1.5.3.tar.gz | cbe212b02faf8c6eed5b6d55ef8a6e363aaab83f15112e960701a9c3df813686 |
none |
These are the same upstream archives as the Mac's FFmpeg artifact 2026.10.09.1
(release macos-ffmpeg-artifact-2026.10.09.1).
Build configuration
- Recipe:
build/nsurator-iphone-native/Config/nsurator-player-core-ios-runtime.json,
run bybuild/nsurator-iphone-native/scripts/build-ios-player-core-runtime.sh
with the player core's scripts at commitd00b24fa7a855e3db9dcbb998876837f31c6e45e
(build/nsurator-player-core-d00b24f/scripts/), work root
/tmp/nsurator-ios-npc-runtime-202611091. - FFmpeg configure line:
records/configure/ffmpeg-iphoneos-arm64-configure.txt
(full record:ffmpeg-iphoneos-arm64-config.mak); the simulator slice differs
only in SDK and target. Link profilebase; extra flags
--enable-libdav1d --disable-securetransport --disable-protocols --enable-protocol=async,bluray,cache,concat,concatf,crypto,data,fd,file,hls,http,pipe,subfile,tcp.
GPL, nonfree and version3 are all off (!CONFIG_GPL,!CONFIG_NONFREE,
!CONFIG_VERSION3in both config records). No TLS is compiled. - libbluray and dav1d: meson, static, release (
records/meson/*-build-options.txt
and the cross files). - Framework: every static archive force-loaded, unchanged, into one dynamic
image per slice bypackage-apple-ffmpeg-runtime-framework.sh --sdk iphoneos
/--sdk iphonesimulator; the exact link command (paths relative to the work
root), the SHA-256 of each input archive and of the export list are in
records/framework/*-FRAMEWORK-RECORD.json. The two slices are joined with
xcodebuild -create-xcframework. - Toolchain: Xcode 27.1 (27A9275), iPhoneOS/iPhoneSimulator 27.1 SDKs, Apple
clang 21.0.0 (clang-2100.3.34.2), meson 1.11.2; minimum iOS 17.0.
Folder contents
| Path | What it is |
|---|---|
ffmpeg/patches/, libbluray/patches/ |
The patches, numbered in the order they are applied |
ffmpeg/CHANGES.md, libbluray/CHANGES.md |
Dated change notices |
*/COPYING*, ffmpeg/LICENSE.md |
Licence texts from the upstream sources |
libudfread/README.md, dav1d/README.md |
Source notes (no changes) |
build/nsurator-player-core-d00b24f/scripts/ |
The player core's build and packaging scripts and its patch directory at commit d00b24f |
build/nsurator-iphone-native/ |
The app repository's runtime recipe, build script, reviewed lock and audit script |
records/ |
Configure and meson records, framework records, toolchain, the app's provenance note (PROVENANCE.md), and the symbols the app imports from the framework: 129 required (app-imports-from-NsuratorPlayerCoreFFmpegRuntime.txt) and 7 weak (app-optional-imports.txt), from a Release build of commit 576834c8 |
assets/ |
The files to attach to the release, and release-assets.sha256 |
Rebuilding
You need a Mac with Xcode 27.1 (iPhoneOS 27.1 SDK), meson, ninja, nasm,
pkg-config and python3.
mkdir work && cd work
tar -xzf ios-ffmpeg-runtime-2026.11.09.1-6e09d2b2-build-scripts-and-records.tar.gz --strip-components=1
mkdir cache && cp ffmpeg-8.1.2.tar.xz libbluray-1.4.1.tar.gz libudfread-1.2.0.tar.gz dav1d-1.5.3.tar.gz cache/
build/nsurator-iphone-native/scripts/build-ios-player-core-runtime.sh \
--core-root "$PWD/build/nsurator-player-core-d00b24f" \
--work-root /tmp/nsurator-ios-npc-runtime-202611091 --source-cache "$PWD/cache"(build-ios-player-core-runtime.sh expects the recipe at ../Config/ from its
own directory, which is how build/nsurator-iphone-native/ is laid out. It
checks every archive's SHA-256, unpacks them, applies the patches and builds
both slices.) The FFmpeg configure line, which contains the work root, is
compiled into the binary, so use the same work root to get the same bytes.
patched-sources.tar.xz holds the four trees after patching, for reading or for
building by hand with the commands in the records.
The build is reproducible: on 2026-11-09 the runtime was built twice in
/tmp/nsurator-ios-npc-runtime-202611091 from a checkout of the player core at
commit d00b24fa (records/toolchain.txt) and the same inputs, and both slices
came out byte-identical (device 6e09d2b2…, simulator c31188df…).
Replacing the framework in the app
A replacement must:
- be a dynamic framework named
NsuratorPlayerCoreFFmpegRuntime.framework
with install name@rpath/NsuratorPlayerCoreFFmpegRuntime.framework/NsuratorPlayerCoreFFmpegRuntime; - be built for arm64 iOS with a deployment target of iOS 17.0 or lower;
- export every symbol in
records/app-imports-from-NsuratorPlayerCoreFFmpegRuntime.txt
with the same C ABI (libavformat 62, libavcodec 62, libavfilter 11, libavutil
60, libswresample 6, libswscale 9, libbluray 1.4 with overlay interface 3 and
bd_select_hdmv_menu_button). Theavpriv_nsurator_*functions in
records/app-optional-imports.txtare weak imports: a framework without them
loads, and the features that use them (HLS subtitle timeline, paired VobSub
through host I/O) switch off.
Put it in place of Frameworks/NsuratorPlayerCoreFFmpegRuntime.framework, then
sign the framework and the app again with your own certificate and a
provisioning profile that includes your device, and install with Xcode or
xcrun devicectl.
What iOS allows: iOS runs only code signed by Apple or by a developer
certificate whose provisioning profile includes the device. Copies of the app
installed from the App Store are encrypted and signed by Apple, so a framework
cannot be replaced inside an App Store installation on an unmodified device.
The replacement steps above work only for a copy of the app that you are able
to sign and install yourself.
iPhone/iPad 1.2.1 (127): FFmpeg runtime 2026.11.08.2 sources
iPhone and iPad app: FFmpeg runtime 2026.11.08.2
Release tag: ios-ffmpeg-runtime-2026.11.08.2-37fd490c
This folder and its release are the corresponding source for
NsuratorPlayerCoreFFmpegRuntime.framework, the media library framework inside
Nsuve (formerly Nsurator) for iPhone and iPad 1.2.1 (build 127), the first build
distributed with it (app commit 30765e37). It replaces runtime 2026.10.10.1 (release
ios-ffmpeg-runtime-2026.10.10.1-80fcefa1): the same sources and recipe, one
more FFmpeg patch (Matroska CueRelativePosition seeks, ffmpeg/CHANGES.md
0014), built with Xcode 27.1. Runtime 2026.11.08.1 (aeed96c0) was never
distributed, nor was a first build of 2026.11.08.2 in another work root (device
slice 5c3b3bc9); the work root is part of the binary, see Rebuilding.
The shipped binary
| Path in the app | NsuratorPhone.app/Frameworks/NsuratorPlayerCoreFFmpegRuntime.framework/NsuratorPlayerCoreFFmpegRuntime |
| Linking | Dynamic framework (shallow iOS bundle, no headers). Install name @rpath/NsuratorPlayerCoreFFmpegRuntime.framework/NsuratorPlayerCoreFFmpegRuntime, compatibility version 1.0.0. The app finds it through @executable_path/Frameworks. |
| Device slice (ios-arm64) SHA-256, before signing | 37fd490c99226e390e49ea14a58d0ac8b42abbd9435c084e703233261882c9c3 (LC_UUID 970F92B7-B193-31DD-A56C-0BDAE9703C68, 22,989,456 bytes) |
| Simulator slice (ios-arm64-simulator) SHA-256 | 765339a09cf3af1eca47b5be81ee7bb53ea9af2bc7b4e4c7d8154ff6ff47681c (LC_UUID CD3C360E-9925-371F-BD9E-8BC315761FAD) |
| Pinned by | build/nsurator-iphone-native/scripts/ios-ffmpeg-runtime-lock.json |
| Contains | FFmpeg (libavformat, libavcodec, libavfilter, libavutil, libswresample, libswscale), libbluray with libudfread, and dav1d. No app code. |
The App Store copy differs from the SHA-256 above only by its code signature;
compare the UUID (dwarfdump --uuid) instead.
Components
| Component | Licence | Upstream archive (attached unchanged) | SHA-256 | Our changes |
|---|---|---|---|---|
| FFmpeg 8.1.2 | LGPL-2.1-or-later | https://ffmpeg.org/releases/ffmpeg-8.1.2.tar.xz | 464beb5e7bf0c311e68b45ae2f04e9cc2af88851abb4082231742a74d97b524c |
14 patches, see ffmpeg/CHANGES.md |
| libbluray 1.4.1 | LGPL-2.1-or-later | https://code.videolan.org/videolan/libbluray/-/archive/1.4.1/libbluray-1.4.1.tar.gz | e22381a313a231d94ddf9180564b36d803f33bdfc7c0b53c03868bc43e5d163d |
4 patches, see libbluray/CHANGES.md |
| libudfread 1.2.0 | LGPL-2.1-or-later | https://code.videolan.org/videolan/libudfread/-/archive/1.2.0/libudfread-1.2.0.tar.gz | adcce1190925f9d35a477757c5e3f0e221315d14d3d45b4ae62540ea0925f877 |
none |
| dav1d 1.5.3 | BSD-2-Clause | https://code.videolan.org/videolan/dav1d/-/archive/1.5.3/dav1d-1.5.3.tar.gz | cbe212b02faf8c6eed5b6d55ef8a6e363aaab83f15112e960701a9c3df813686 |
none |
These are the same upstream archives as the Mac's FFmpeg artifact 2026.10.09.1
(release macos-ffmpeg-artifact-2026.10.09.1).
Build configuration
- Recipe:
build/nsurator-iphone-native/Config/nsurator-player-core-ios-runtime.json,
run bybuild/nsurator-iphone-native/scripts/build-ios-player-core-runtime.sh
with the player core's scripts at commite50a3b0b342c6cc6f12199800621678ed76baf25
(build/nsurator-player-core-e50a3b0/scripts/), work root
/tmp/nsurator-ios-npc-runtime-202611082. - FFmpeg configure line:
records/configure/ffmpeg-iphoneos-arm64-configure.txt
(full record:ffmpeg-iphoneos-arm64-config.mak); the simulator slice differs
only in SDK and target. Link profilebase; extra flags
--enable-libdav1d --disable-securetransport --disable-protocols --enable-protocol=async,bluray,cache,concat,concatf,crypto,data,fd,file,hls,http,pipe,subfile,tcp.
GPL, nonfree and version3 are all off (!CONFIG_GPL,!CONFIG_NONFREE,
!CONFIG_VERSION3in both config records). No TLS is compiled. - libbluray and dav1d: meson, static, release (
records/meson/*-build-options.txt
and the cross files). - Framework: every static archive force-loaded, unchanged, into one dynamic
image per slice bypackage-apple-ffmpeg-runtime-framework.sh --sdk iphoneos
/--sdk iphonesimulator; the exact link command (paths relative to the work
root), the SHA-256 of each input archive and of the export list are in
records/framework/*-FRAMEWORK-RECORD.json. The two slices are joined with
xcodebuild -create-xcframework. - Toolchain: Xcode 27.1 (27A9275), iPhoneOS/iPhoneSimulator 27.1 SDKs, Apple
clang 21.0.0 (clang-2100.3.34.2), meson 1.11.2; minimum iOS 17.0.
Folder contents
| Path | What it is |
|---|---|
ffmpeg/patches/, libbluray/patches/ |
The patches, numbered in the order they are applied |
ffmpeg/CHANGES.md, libbluray/CHANGES.md |
Dated change notices |
*/COPYING*, ffmpeg/LICENSE.md |
Licence texts from the upstream sources |
libudfread/README.md, dav1d/README.md |
Source notes (no changes) |
build/nsurator-player-core-e50a3b0/scripts/ |
The player core's build and packaging scripts and its patch directory at commit e50a3b0 |
build/nsurator-iphone-native/ |
The app repository's runtime recipe, build script, reviewed lock and audit script |
records/ |
Configure and meson records, framework records, toolchain, the app's provenance note (PROVENANCE.md), and the symbols the app imports from the framework: 129 required (app-imports-from-NsuratorPlayerCoreFFmpegRuntime.txt) and 7 weak (app-optional-imports.txt), from a Release build of commit 30765e37 |
assets/ |
The files to attach to the release, and release-assets.sha256 |
Rebuilding
You need a Mac with Xcode 27.1 (iPhoneOS 27.1 SDK), meson, ninja, nasm,
pkg-config and python3.
mkdir work && cd work
tar -xzf ios-ffmpeg-runtime-2026.11.08.2-37fd490c-build-scripts-and-records.tar.gz --strip-components=1
mkdir cache && cp ffmpeg-8.1.2.tar.xz libbluray-1.4.1.tar.gz libudfread-1.2.0.tar.gz dav1d-1.5.3.tar.gz cache/
build/nsurator-iphone-native/scripts/build-ios-player-core-runtime.sh \
--core-root "$PWD/build/nsurator-player-core-e50a3b0" \
--work-root /tmp/nsurator-ios-npc-runtime-202611082 --source-cache "$PWD/cache"(build-ios-player-core-runtime.sh expects the recipe at ../Config/ from its
own directory, which is how build/nsurator-iphone-native/ is laid out. It
checks every archive's SHA-256, unpacks them, applies the patches and builds
both slices.) The FFmpeg configure line, which contains the work root, is
compiled into the binary, so use the same work root to get the same bytes.
patched-sources.tar.xz holds the four trees after patching, for reading or for
building by hand with the commands in the records.
The build is reproducible: on 2026-11-09 the runtime was built three times in
/tmp/nsurator-ios-npc-runtime-202611082 from the same inputs, and both slices came out byte-identical
each time (device 37fd490c…, simulator 765339a0…). The first two builds ran
from these files laid out as above (--core-root the
build/nsurator-player-core-e50a3b0 folder), the third from a checkout of the
player core at commit e50a3b0b (records/toolchain.txt).
Replacing the framework in the app
A replacement must:
- be a dynamic framework named
NsuratorPlayerCoreFFmpegRuntime.framework
with install name@rpath/NsuratorPlayerCoreFFmpegRuntime.framework/NsuratorPlayerCoreFFmpegRuntime; - be built for arm64 iOS with a deployment target of iOS 17.0 or lower;
- export every symbol in
records/app-imports-from-NsuratorPlayerCoreFFmpegRuntime.txt
with the same C ABI (libavformat 62, libavcodec 62, libavfilter 11, libavutil
60, libswresample 6, libswscale 9, libbluray 1.4 with overlay interface 3 and
bd_select_hdmv_menu_button). Theavpriv_nsurator_*functions in
records/app-optional-imports.txtare weak imports: a framework without them
loads, and the features that use them (HLS subtitle timeline, paired VobSub
through host I/O) switch off.
Put it in place of Frameworks/NsuratorPlayerCoreFFmpegRuntime.framework, then
sign the framework and the app again with your own certificate and a
provisioning profile that includes your device, and install with Xcode or
xcrun devicectl.
What iOS allows: iOS runs only code signed by Apple or by a developer
certificate whose provisioning profile includes the device. Copies of the app
installed from the App Store are encrypted and signed by Apple, so a framework
cannot be replaced inside an App Store installation on an unmodified device.
The replacement steps above work only for a copy of the app that you are able
to sign and install yourself.
iPhone/iPad 1.0.3 (103) and 1.0.4 (104): FFmpeg runtime 2026.10.10.1 sources
iPhone and iPad app: FFmpeg runtime 2026.10.10.1
Release tag: ios-ffmpeg-runtime-2026.10.10.1-80fcefa1
This folder and its release are the corresponding source for
NsuratorPlayerCoreFFmpegRuntime.framework, the media library framework inside
Nsurator for iPhone and iPad 1.0.3 (build 103) and 1.0.4 (build 104), the
builds that play through the shared player core (first app commit 8d06cdd;
1.0.4 is app commit eeaf8d8 on main). It replaces the 1.0.1 runtime
VisionPlayerCoreFFmpegRuntime (release ios-1.0.1-ffmpeg-runtime-94a31390).
Both builds embed the same binary, byte for byte before signing.
The shipped binary
| Path in the app | NsuratorPhone.app/Frameworks/NsuratorPlayerCoreFFmpegRuntime.framework/NsuratorPlayerCoreFFmpegRuntime |
| Linking | Dynamic framework (shallow iOS bundle, no headers). Install name @rpath/NsuratorPlayerCoreFFmpegRuntime.framework/NsuratorPlayerCoreFFmpegRuntime, compatibility version 1.0.0. The app finds it through @executable_path/Frameworks. |
| Device slice (ios-arm64) SHA-256, before signing | 80fcefa1b69d423df5e7dde95156e9189118f1cef2b00c0b99bb9c94a3a5d2ea (LC_UUID A4A43AE8-105A-31F4-88CA-C5EAA327E028, 22,989,296 bytes) |
| Simulator slice (ios-arm64-simulator) SHA-256 | bbd2798118f181e94802f9d7f12e085a597342d84f616de26156bbbf832c7dc0 (LC_UUID E92981BB-B2F9-3041-BB08-9476BCD156D5) |
| Pinned by | build/nsurator-iphone-native/scripts/ios-ffmpeg-runtime-lock.json |
| Contains | FFmpeg (libavformat, libavcodec, libavfilter, libavutil, libswresample, libswscale), libbluray with libudfread, and dav1d. No app code. |
The App Store copy differs from the SHA-256 above only by its code signature;
compare the UUID (dwarfdump --uuid) instead.
Components
| Component | Licence | Upstream archive (attached unchanged) | SHA-256 | Our changes |
|---|---|---|---|---|
| FFmpeg 8.1.2 | LGPL-2.1-or-later | https://ffmpeg.org/releases/ffmpeg-8.1.2.tar.xz | 464beb5e7bf0c311e68b45ae2f04e9cc2af88851abb4082231742a74d97b524c |
13 patches, see ffmpeg/CHANGES.md |
| libbluray 1.4.1 | LGPL-2.1-or-later | https://code.videolan.org/videolan/libbluray/-/archive/1.4.1/libbluray-1.4.1.tar.gz | e22381a313a231d94ddf9180564b36d803f33bdfc7c0b53c03868bc43e5d163d |
4 patches, see libbluray/CHANGES.md |
| libudfread 1.2.0 | LGPL-2.1-or-later | https://code.videolan.org/videolan/libudfread/-/archive/1.2.0/libudfread-1.2.0.tar.gz | adcce1190925f9d35a477757c5e3f0e221315d14d3d45b4ae62540ea0925f877 |
none |
| dav1d 1.5.3 | BSD-2-Clause | https://code.videolan.org/videolan/dav1d/-/archive/1.5.3/dav1d-1.5.3.tar.gz | cbe212b02faf8c6eed5b6d55ef8a6e363aaab83f15112e960701a9c3df813686 |
none |
These are the same upstream archives as the Mac's FFmpeg artifact 2026.10.09.1
(release macos-ffmpeg-artifact-2026.10.09.1).
Build configuration
- Recipe:
build/nsurator-iphone-native/Config/nsurator-player-core-ios-runtime.json,
run bybuild/nsurator-iphone-native/scripts/build-ios-player-core-runtime.sh
with the player core's scripts at commit307ff7139d1066a5efe2161ceddf4a81eae0ce08
(build/nsurator-player-core-307ff71/scripts/), work root
/tmp/nsurator-ios-npc-runtime-202610101. - FFmpeg configure line:
records/configure/ffmpeg-iphoneos-arm64-configure.txt
(full record:ffmpeg-iphoneos-arm64-config.mak); the simulator slice differs
only in SDK and target. Link profilebase; extra flags
--enable-libdav1d --disable-securetransport --disable-protocols --enable-protocol=async,bluray,cache,concat,concatf,crypto,data,fd,file,hls,http,pipe,subfile,tcp.
GPL, nonfree and version3 are all off (!CONFIG_GPL,!CONFIG_NONFREE,
!CONFIG_VERSION3in both config records). No TLS is compiled. - libbluray and dav1d: meson, static, release (
records/meson/*-build-options.txt
and the cross files). - Framework: every static archive force-loaded, unchanged, into one dynamic
image per slice bypackage-apple-ffmpeg-runtime-framework.sh --sdk iphoneos
/--sdk iphonesimulator; the exact link command (paths relative to the work
root), the SHA-256 of each input archive and of the export list are in
records/framework/*-FRAMEWORK-RECORD.json. The two slices are joined with
xcodebuild -create-xcframework. - Toolchain: Xcode 27.0 (27A266a), iPhoneOS/iPhoneSimulator 27.0 SDKs, Apple
clang 21.0.0 (clang-2100.3.34.2), meson 1.11.2; minimum iOS 17.0.
Folder contents
| Path | What it is |
|---|---|
ffmpeg/patches/, libbluray/patches/ |
The patches, numbered in the order they are applied |
ffmpeg/CHANGES.md, libbluray/CHANGES.md |
Dated change notices |
*/COPYING*, ffmpeg/LICENSE.md |
Licence texts from the upstream sources |
libudfread/README.md, dav1d/README.md |
Source notes (no changes) |
build/nsurator-player-core-307ff71/scripts/ |
The player core's build and packaging scripts and its patch directory at commit 307ff71 |
build/nsurator-iphone-native/ |
The app repository's runtime recipe, build script, reviewed lock and audit script |
records/ |
Configure and meson records, framework records, toolchain, the app's provenance note (PROVENANCE.md), and the symbols the app imports from the framework: 120 required (app-imports-from-NsuratorPlayerCoreFFmpegRuntime.txt) and 7 weak (app-optional-imports.txt), from a Release build of commit 8d06cdd |
assets/ |
The files to attach to the release, and release-assets.sha256 |
Rebuilding
You need a Mac with Xcode 27.0 (iPhoneOS 27.0 SDK), meson, ninja, nasm,
pkg-config and python3.
mkdir work && cd work
tar -xzf ios-ffmpeg-runtime-2026.10.10.1-80fcefa1-build-scripts-and-records.tar.gz --strip-components=1
mkdir cache && cp ffmpeg-8.1.2.tar.xz libbluray-1.4.1.tar.gz libudfread-1.2.0.tar.gz dav1d-1.5.3.tar.gz cache/
build/nsurator-iphone-native/scripts/build-ios-player-core-runtime.sh \
--core-root "$PWD/build/nsurator-player-core-307ff71" \
--work-root /tmp/nsurator-ios-npc-runtime-202610101 --source-cache "$PWD/cache"(build-ios-player-core-runtime.sh expects the recipe at ../Config/ from its
own directory, which is how build/nsurator-iphone-native/ is laid out. It
checks every archive's SHA-256, unpacks them, applies the patches and builds
both slices.) The FFmpeg configure line, which contains the work root, is
compiled into the binary, so use the same work root to get the same bytes.
patched-sources.tar.xz holds the four trees after patching, for reading or for
building by hand with the commands in the records.
The build is reproducible: on 2026-10-10 the runtime was built twice in
/tmp/nsurator-ios-npc-runtime-202610101 from the same inputs, and both slices
were byte-identical (device 80fcefa1…, simulator bbd27981…). The player core
commit that ran was 307ff713 the first time and 09825fa6 (documentation
only on top of it) the second; the scripts are the same in both.
Replacing the framework in the app
A replacement must:
- be a dynamic framework named
NsuratorPlayerCoreFFmpegRuntime.framework
with install name@rpath/NsuratorPlayerCoreFFmpegRuntime.framework/NsuratorPlayerCoreFFmpegRuntime; - be built for arm64 iOS with a deployment target of iOS 17.0 or lower;
- export every symbol in
records/app-imports-from-NsuratorPlayerCoreFFmpegRuntime.txt
with the same C ABI (libavformat 62, libavcodec 62, libavfilter 11, libavutil
60, libswresample 6, libswscale 9, libbluray 1.4 with overlay interface 3 and
bd_select_hdmv_menu_button). Theavpriv_nsurator_*functions in
records/app-optional-imports.txtare weak imports: a framework without them
loads, and the features that use them (HLS subtitle timeline, paired VobSub
through host I/O) switch off.
Put it in place of Frameworks/NsuratorPlayerCoreFFmpegRuntime.framework, then
sign the framework and the app again with your own certificate and a
provisioning profile that includes your device, and install with Xcode or
xcrun devicectl.
What iOS allows: iOS runs only code signed by Apple or by a developer
certificate whose provisioning profile includes the device. Copies of the app
installed from the App Store are encrypted and signed by Apple, so a framework
cannot be replaced inside an App Store installation on an unmodified device.
The replacement steps above work only for a copy of the app that you are able
to sign and install yourself.
Mac: ffmpeg/ffprobe tools 2026.08.10.1 sources
Corresponding source for the bundled ffmpeg and ffprobe programs (Contents/Resources/PlaybackTools/) in Nsurator for Mac builds made on or after 2026-08-11: versions 6.9.9 through 6.9.17 and 5.9.17. The tools are separate programs that the app starts as child processes.
This release covers only these two programs. The player libraries linked into the app itself are covered by macos-ffmpeg-artifact-2026.09.24.1 for builds made on or after 2026-09-24; builds made from 2026-08-11 to 2026-09-23 used earlier player library builds that no release here covers.
| Component | Licence | Our changes |
|---|---|---|
| FFmpeg 8.1.2 | LGPL-2.1-or-later | none |
| FriBidi 1.0.16 | LGPL-2.1-or-later | none |
| libass 0.17.5 | ISC | none |
| FreeType 2.14.3 | FTL | none |
| HarfBuzz 14.3.0 | MIT | none |
| libunibreak 7.0 | Zlib | none |
| libpng 1.6.58 | libpng-2.0 | none |
Nothing is patched, so this release has no patch or patched-source archive: the build compiled the upstream archives attached here.
Assets:
- the seven upstream source archives, as the build used them
macos-media-tools-ffmpeg-8.1.2-lgpl-arm64-2026.08.10.1-build-scripts-and-records.tar.gz: build script, source pins, configure records, licencesSHA256SUMS: check withshasum -a 256 -c SHA256SUMS
How to rebuild and replace the tools: macos-media-tools-ffmpeg-8.1.2-lgpl-arm64-2026.08.10.1/README.md.
中文:本 Release 是 Nsurator for Mac(2026-08-11 及之后的构建:6.9.9 至 6.9.17,以及 5.9.17)附带的 ffmpeg / ffprobe 独立程序的对应源码:FFmpeg 8.1.2、FriBidi 1.0.16(LGPL)以及 libass、FreeType、HarfBuzz、libunibreak、libpng,全部未修改,因此没有补丁包。本 Release 只覆盖这两个程序;应用本身链接的播放核心库,2026-09-24 及之后的构建见 macos-ffmpeg-artifact-2026.09.24.1,2026-08-11 至 2026-09-23 之间的构建使用更早的播放核心库,本仓库没有对应的 Release。附件为七个上游源码包、构建脚本与记录以及 SHA256SUMS。重新构建与替换方法见上面链接的 README。
Mac (after 5.9.17 build 8): player FFmpeg artifact 2026.10.09.1 sources (dynamic framework)
Corresponding source for FFmpeg 8.1.2, libbluray 1.4.1 and libudfread 1.2.0 (LGPL-2.1-or-later), and dav1d 1.5.3 (BSD-2-Clause), as they ship in Nsurator for Mac's player in builds that load them dynamically: Mac player artifact 2026.10.09.1.
Which Mac builds use it. The first Mac App Store version submitted after 5.9.17 (build 8), and every build made from the app source at or after commit 3fd9615e, which pinned this artifact. 5.9.17 (build 8) and earlier distributed builds link artifact 2026.09.24.1 statically; their source is release macos-ffmpeg-artifact-2026.09.24.1.
Same compiled code as 2026.09.24.1. Nothing was rebuilt from source. The eight static libraries of artifact 2026.09.24.1 (checksums in the README) are linked unchanged into one framework, Contents/Frameworks/NsuratorPlayerCoreFFmpegRuntime.framework. The app executable and its decoder helper load it through @rpath and carry no copy of the libraries. Sources, patches and build configuration are therefore those of 2026.09.24.1. The upstream archives and the patch and patched-source archives attached here are byte-identical to that release's assets and keep their 2026.09.24.1 names.
Replacing the framework.
- Rebuild the libraries from the attached sources with
build/nsurator-player-core-8c27b0c/scripts/build-ffmpeg-apple.sh, keeping thebaseprofile. - Build the framework with
build/nsurator-player-core-ebfc8a0/scripts/package-apple-ffmpeg-runtime-framework.sh --build. With the same libraries and toolchain it reproduces the shipped binary: SHA-256d6fe5a3e…1cff, LC_UUID58BB2D7D-52C4-3BC0-9CD2-5C811162D69A. - Keep the framework name, the install name and the functions listed in
records/app/, and put your framework in place ofNsurator.app/Contents/Frameworks/NsuratorPlayerCoreFFmpegRuntime.framework. - Re-sign inner code first: the framework, then
Contents/XPCServices/NsuratorDecoderProbeHelper.xpc, then the app. Either sign all three with one identity of your own, or sign them ad hoc and give the app and the helpercom.apple.security.cs.disable-library-validation.
The full commands are in the folder's README.
Mac App Store signing caveat. A copy you re-sign no longer carries the Mac App Store signature. Features tied to it can stop working in that copy: in-app purchases, and data containers and app groups bound to the developer's team. Entitlements that need a provisioning profile must be left out.
Folder: https://github.com/imranulhSH/lgpl-sources/tree/main/macos-ffmpeg-artifact-2026.10.09.1 · SHA256SUMS lists every attached file.
Mac 5.9.17 (8): player FFmpeg artifact 2026.09.24.1 sources
Corresponding source for the player libraries in Nsurator for Mac 5.9.17 (build 8), builds made on or after 2026-09-24. These libraries are linked statically into the app executable NsuratorNative and the decoder helper NsuratorDecoderProbeHelper.
| Component | Licence | Our changes |
|---|---|---|
| FFmpeg 8.1.2 | LGPL-2.1-or-later | 7 patches (2 of them compiled; the build uses --disable-network) |
| libbluray 1.4.1 | LGPL-2.1-or-later | 3 patches |
| libudfread 1.2.0 | LGPL-2.1-or-later | none |
| dav1d 1.5.3 | BSD-2-Clause | none |
Assets:
ffmpeg-8.1.2.tar.xz,libbluray-1.4.1.tar.gz,libudfread-1.2.0.tar.gz,dav1d-1.5.3.tar.gz: upstream sources as the build used themmacos-ffmpeg-artifact-2026.09.24.1-patches.tar.gz: our patches and dated change noticesmacos-ffmpeg-artifact-2026.09.24.1-patched-sources.tar.xz: the source tree the build compiledmacos-ffmpeg-artifact-2026.09.24.1-build-scripts-and-records.tar.gz: build scripts, configure line, artifact records, licencesSHA256SUMS: check withshasum -a 256 -c SHA256SUMS
Relinking the app with modified libraries needs the app's object files, which are not part of this release; see https://www.nsurator.com/support.html#oss. Rebuild steps and what could not be pinned: macos-ffmpeg-artifact-2026.09.24.1/README.md.
中文:本 Release 是 Nsurator for Mac 5.9.17(build 8,2026-09-24 及之后的构建)播放核心中各库的对应源码。这些库静态链接进应用主程序 NsuratorNative 与解码辅助进程 NsuratorDecoderProbeHelper:FFmpeg 8.1.2(7 个补丁)、libbluray 1.4.1(3 个补丁)、libudfread 1.2.0、dav1d 1.5.3(后两者未修改)。重新链接需要应用的目标文件,不在本 Release 中,获取方式见 https://www.nsurator.com/support.html#oss 。重新构建方法见上面链接的 README。