SPB Git

Repository Public License

NOTICE.md 10.8 KB

# Bundled FFmpeg (ffmpeg + ffprobe) — notices

ORIX Convert ships two helper executables built by EmbeddedEngines/ffmpeg/build.sh:

File Installed as Role
EmbeddedEngines/tools/ffmpeg ORIX Convert.app/Contents/Helpers/ffmpeg video and audio conversion
EmbeddedEngines/tools/ffprobe ORIX Convert.app/Contents/Helpers/ffprobe reading media files

They are separate programs. ORIX Convert never links FFmpeg code into its own binary: it starts these executables as child processes (ProcessRunner, argument arrays, no shell) and talks to them through files and pipes.

# What is inside

Build of 2026-11-21, arm64, MACOSX_DEPLOYMENT_TARGET=15.0, Apple clang 21.0.0 (Xcode 27.2).

Component Version License Source (pinned) SHA-256 of the archive How it is used
FFmpeg 9.1 LGPL-2.1-or-later (this configuration) https://ffmpeg.org/releases/ffmpeg-9.1.tar.xz 1a4d394ae63d190a526cd052eb4415c156b5c5e2df37efab41a7de0b8fde2433 the two executables
LAME (libmp3lame) 3.100 LGPL-2.0-or-later https://downloads.sourceforge.net/project/lame/lame/3.100/lame-3.100.tar.gz ddfe36cab873794038ae2c1210557ad34857a4b6bdc515785d1da9e175b1da1e MP3 encoder, static
Opus (libopus) 1.6.1 BSD-3-Clause, with the Opus patent licences https://downloads.xiph.org/releases/opus/opus-1.6.1.tar.gz 6ffcb593207be92584df15b32466ed64bbec99109f007c82205f0194572411a1 Opus encoder, static
libogg 1.3.6 BSD-3-Clause https://downloads.xiph.org/releases/ogg/libogg-1.3.6.tar.xz 5c8253428e181840cd20d41f3ca16557a9cc04bad4a3d04cce84808677fa1061 needed by libvorbis, static
libvorbis 1.3.7 BSD-3-Clause https://downloads.xiph.org/releases/vorbis/libvorbis-1.3.7.tar.xz b33cc4934322bcbf6efcbacf49e3ca01aadbea4114ec9589d1b1e9d20f72954b Vorbis encoder, static
libvpx 1.17.0 BSD-3-Clause, with the WebM patent grant https://github.com/webmproject/libvpx/archive/refs/tags/v1.17.0.tar.gz 1020f184046187baa2985dbde38e0691f49c44088bca7a1842b0236c6081dc0a VP8 / VP9 encoders, static
SVT-AV1 4.3.0 BSD-3-Clause-Clear, with the Alliance for Open Media Patent License 1.0 https://gitlab.com/AOMediaCodec/SVT-AV1/-/archive/v4.3.0/SVT-AV1-v4.3.0.tar.gz 95ce8fc2381ba707e65ac8b9b2e165915bfbe9cd4d2f7b0f58d64ce31bd98f6d AV1 encoder, static
dav1d 1.5.5 BSD-2-Clause https://downloads.videolan.org/pub/videolan/dav1d/1.5.5/dav1d-1.5.5.tar.xz ca96b1d0ba3f01f55de7231d775892b64994ba061aaeeaaa4f662a390b3abf9e AV1 decoder, static
zimg 3.0.6 WTFPL v2 https://github.com/sekrit-twc/zimg/archive/refs/tags/release-3.0.6.tar.gz be89390f13a5c9b2388ce0f44a5e89364a20c1c57ce46d382b1fcc3967057577 zscale filter (HDR → SDR tone mapping), static

Build-time tools, not shipped: pkgconf 3.0.11 (ISC, d0cd841bc8e55b9da888106c00dc256d05b7d1d8e5a46f4be4eb4c5125bd2dc4), Meson 1.6.1 (Apache-2.0, 1eca49eb6c26d58bbee67fd3337d8ef557c0804e30a6d16bfdf269db997464de — the last line that runs on the Python 3.9 of the Xcode command-line tools), plus cmake and ninja from the build machine.

The SHA-256 values were computed on the archives downloaded on 2026-11-21 and are enforced by build.sh; the dav1d value was also compared with the .sha256 file published next to the archive. LAME 3.100 (2017) is used rather than the newer 3.101 / 4.0 lines because it is the release FFmpeg's libmp3lame wrapper has been validated against for years.

System components the executables load at run time (otool -L): libSystem, libz, libiconv, libc++, and the frameworks VideoToolbox, AudioToolbox, CoreMedia, CoreVideo, CoreFoundation, CoreServices. Nothing from Homebrew or /usr/local.

# What is deliberately not inside

  • No GPL, no non-free code: FFmpeg is configured without --enable-gpl, --enable-version3 and --enable-nonfree. There is no x264, x265, fdk-aac, libaom, libwebp, librubberband, frei0r or other GPL part, and FFmpeg's own GPL-only filters are not compiled. ffmpeg -L prints the LGPL-2.1-or-later notice.
  • No network: --disable-network, and the only protocols compiled in are file and pipe (ffmpeg -protocols). The binaries cannot open a URL. ORIX Convert additionally passes -protocol_whitelist file,pipe before every input and always -nostdin.
  • No capture or playback: --disable-avdevice, no ffplay.
  • Encoders are a whitelist (decoders, demuxers, parsers and filters are FFmpeg's full LGPL set, so that as many files as possible can be read): H.264 / HEVC / ProRes through VideoToolbox, prores_ks, SVT-AV1, libvpx VP8/VP9, MPEG-4 Part 2, MPEG-2, MPEG-1, WMV1/WMV2, MS-MPEG4v3, FLV1, MJPEG, PNG/APNG, GIF; AAC (aac and AudioToolbox aac_at), ALAC, FLAC, MP3 (LAME), Opus, Vorbis, WMA1/WMA2, MP2, AC-3, PCM; SubRip, ASS/SSA, WebVTT, MOV text.
  • No JIT and no special entitlement is needed: the executables run under the Hardened Runtime as they are.

# Exact configure line

ffmpeg -buildconf prints the configuration embedded in the binary. The whole build runs through the fixed symlink /tmp/orix-convert-ffmpeg (created by build.sh, pointing at EmbeddedEngines/ffmpeg/, removed when it ends), so the line is the same on every build machine and no user name or checkout path ends up in the executables:

text
--prefix=/tmp/orix-convert-ffmpeg/prefix --arch=arm64 --target-os=darwin --cc=clang --cxx=clang++
--pkg-config=/tmp/orix-convert-ffmpeg/work/tools/bin/pkgconf --pkg-config-flags=--static
--extra-cflags='-mmacosx-version-min=15.0 -I/tmp/orix-convert-ffmpeg/prefix/include -ffile-prefix-map=/tmp/orix-convert-ffmpeg=.'
--extra-ldflags='-mmacosx-version-min=15.0 -L/tmp/orix-convert-ffmpeg/prefix/lib' --extra-libs=-liconv
--disable-shared --enable-static --enable-pic --disable-debug --disable-doc
--disable-autodetect --disable-network --disable-avdevice
--disable-ffplay --enable-ffmpeg --enable-ffprobe
--disable-protocols --enable-protocol='file,pipe'
--disable-encoders --enable-encoder='h264_videotoolbox,hevc_videotoolbox,prores_videotoolbox,prores_ks,libsvtav1,libvpx_vp8,libvpx_vp9,mpeg4,mpeg2video,mpeg1video,wmv2,wmv1,msmpeg4v3,flv,mjpeg,png,apng,gif,rawvideo,aac,aac_at,alac,flac,libmp3lame,libopus,libvorbis,wmav2,wmav1,mp2,ac3,pcm_s16le,pcm_s24le,pcm_s32le,pcm_f32le,pcm_f64le,pcm_s16be,pcm_s24be,pcm_s32be,pcm_f32be,pcm_f64be,pcm_s8,pcm_u8,pcm_alaw,pcm_mulaw,subrip,srt,ass,ssa,webvtt,movtext,text,wrapped_avframe'
--disable-muxers --enable-muxer='mp4,mov,ipod,matroska,webm,avi,mpeg1system,mpeg2vob,mpeg2dvd,mpegts,flv,asf,ogg,opus,oga,flac,wav,aiff,caf,mp3,adts,mp2,ac3,srt,ass,webvtt,gif,apng,null,md5,framemd5,hash,framehash,streamhash,framecrc,crc,image2,image2pipe,rawvideo,pcm_s16le,pcm_s24le,pcm_s32le,pcm_f32le,ffmetadata'
--enable-videotoolbox --enable-audiotoolbox --enable-zlib --enable-iconv
--enable-libsvtav1 --enable-libdav1d --enable-libvpx --enable-libmp3lame --enable-libopus --enable-libvorbis --enable-libzimg

The codec libraries are configured as shown in build.sh; the only change made to any source is one sed on libvorbis' 2020 configure script, removing the linker flag -force_cpusubtype_ALL that current Apple linkers reject. zimg's release archive has no generated configure; its C++ sources are compiled directly with the definitions its own Makefile.am uses for an ARM NEON build. No FFmpeg source file is modified.

# LGPL compliance approach

  1. Separate, replaceable executables. FFmpeg (LGPL-2.1-or-later) and LAME (LGPL-2.0-or-later) are combined only with each other and with permissively licensed libraries, inside ffmpeg and ffprobe. Those two programs as a whole are distributed under the LGPL-2.1-or-later. ORIX Convert itself is a different program that merely runs them; it is not a derivative work and contains no LGPL code.
  2. The user can substitute their own build. Any ffmpeg / ffprobe with the same command-line interface can replace the bundled ones: either by replacing the two files in Contents/Helpers (then re-signing the app, e.g. codesign --force --deep --sign - "ORIX Convert.app"), or without touching the app by setting the environment variable ORIX_CONVERT_TOOLS to a directory containing them, which BundledTools searches first.
  3. Complete corresponding source. The table above names the exact upstream archives and their hashes; build.sh is the complete build recipe (configure options included), and this file records the single change made to a build script. The release must make these archives available alongside the app (see the written offer).
  4. Notices. The app's acknowledgements must state that it uses FFmpeg and LAME under the LGPL and reproduce the licence texts collected by build.sh in EmbeddedEngines/ffmpeg/licenses/ (FFmpeg COPYING.LGPLv2.1 and LICENSE.md, LAME COPYING, and the BSD / WTFPL / patent-grant texts of the other libraries).
  5. No restriction on reverse engineering of the LGPL parts may appear in the app's licence terms for the purpose of debugging modifications to them (LGPL-2.1 §6).

# Written offer (text to ship with the app)

ORIX Convert includes the programs ffmpeg and ffprobe, built from FFmpeg 9.1 (https://ffmpeg.org) and LAME 3.100 (https://lame.sourceforge.io), which are free software licensed under the GNU Lesser General Public License, version 2.1 or later (LAME: version 2 or later), together with libopus, libogg, libvorbis, libvpx, SVT-AV1, dav1d and zimg under their respective permissive licences. You may replace these programs with your own builds. The script that builds them, with the upstream download address and the SHA-256 of every source archive of the exact versions used, is published at https://git.spboucher.ai/orix-convert (file EmbeddedEngines/ffmpeg/build.sh); the source archives are the unmodified upstream releases it names. For at least three years after the last distribution of this version, the complete corresponding source code is also available on request to contact@spboucher.ai for no more than the cost of physically performing the distribution.

(The source archives themselves are not stored in the repository: they are the unmodified upstream releases, pinned by hash in build.sh. No FFmpeg or codec source file is modified.)

# Binary sizes (stripped, arm64) — build of 2026-11-21

File Size SHA-256
ffmpeg 29 573 888 bytes (28.2 MB) 7c642a9ba12ff99ee74cdc8ead561a5e1b79bd3b1858ff0df44e8e88ed3fa743
ffprobe 29 365 520 bytes (28.0 MB) 5e28080528f07b7f663f1c7a1ab1ee1cb763f39d0fb5dfb9f2b1d554fcacff95

Two builds from scratch on the same machine (sources unpacked again, every library rebuilt) produced byte-identical executables — these hashes. Reproducibility on another machine or with another Xcode version has not been checked. The hashes are those of the ad-hoc-signed files written by build.sh; re-signing for release changes them.

Files main
Menu

Theme