# FFmpeg 8.0.1 Build Manifest
# Used in Underbar.app v1.0.0

## Source Information
Official Source: https://ffmpeg.org/releases/ffmpeg-8.0.1.tar.xz
Official Site: https://ffmpeg.org
Release Date: 2024-11-20
SHA256: (download and verify from official source)

## Build Method
Built via Homebrew formula on macOS 14.0 (Sonoma)
Homebrew Formula: https://github.com/Homebrew/homebrew-core/blob/master/Formula/f/ffmpeg.rb

## Build Configuration
The following configuration was used (from Homebrew formula):

--prefix=/opt/homebrew/Cellar/ffmpeg/8.0.1
--enable-shared
--enable-pthreads
--enable-version3
--cc=clang
--host-cflags=
--host-ldflags=
--enable-ffplay
--enable-gnutls
--enable-gpl
--enable-libaom
--enable-libaribb24
--enable-libbluray
--enable-libdav1d
--enable-libharfbuzz
--enable-libjxl
--enable-libmp3lame
--enable-libopus
--enable-librav1e
--enable-librist
--enable-librubberband
--enable-libsnappy
--enable-libsrt
--enable-libssh
--enable-libsvtav1
--enable-libtesseract
--enable-libtheora
--enable-libvidstab
--enable-libvmaf
--enable-libvorbis
--enable-libvpx
--enable-libwebp
--enable-libx264
--enable-libx265
--enable-libxml2
--enable-libxvid
--enable-lzma
--enable-libfontconfig
--enable-libfreetype
--enable-frei0r
--enable-libass
--enable-libopencore-amrnb
--enable-libopencore-amrwb
--enable-libopenjpeg
--enable-libspeex
--enable-libsoxr
--enable-libzmq
--enable-libzimg
--disable-libjack
--disable-indev=jack
--enable-videotoolbox
--enable-audiotoolbox
--enable-neon

## GPL-Licensed Libraries Included
- libx264 (H.264 encoder) - GPL v2+
- libx265 (HEVC encoder) - GPL v2+

Due to these GPL libraries, the entire FFmpeg binary is GPL v2+ licensed.

## Compiler Information
Compiler: Apple clang version 17.0.0 (clang-1700.4.4.1)
Target: arm64-apple-darwin24.1.0 (macOS 14.0+)

## Hardware Acceleration
VideoToolbox encoders enabled:
- h264_videotoolbox (H.264 hardware encoding)
- hevc_videotoolbox (H.265/HEVC hardware encoding)
- prores_videotoolbox (ProRes hardware encoding)

AudioToolbox enabled for hardware audio processing.

## Binary Information
Architecture: arm64 (Apple Silicon native)
File Size: ~478 KB (executable only, depends on Homebrew libraries)
Location in App: Underbar.app/Contents/Resources/Tools/ffmpeg

## Dependencies
FFmpeg depends on libraries in /opt/homebrew/lib/:
- libavcodec, libavformat, libavutil, libavfilter, libswscale, libswresample
- libx264, libx265 (GPL)
- libaom, libdav1d, libvpx, libwebp (codec libraries)
- Additional dependencies per Homebrew formula

## Reproducing This Build

### Prerequisites
- macOS 14.0 or later
- Xcode 15.0 or later (for clang)
- Homebrew (https://brew.sh)

### Steps
```bash
# Install Homebrew (if not already installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install FFmpeg via Homebrew (builds from official source)
brew install ffmpeg

# Binary will be at:
/opt/homebrew/bin/ffmpeg  # Apple Silicon
# or
/usr/local/bin/ffmpeg     # Intel

# Verify version
ffmpeg -version

# Check VideoToolbox support
ffmpeg -encoders | grep videotoolbox
```

## Obtaining Source Code

### Option 1: Direct Download (Recommended)
```bash
wget https://ffmpeg.org/releases/ffmpeg-8.0.1.tar.xz
tar -xf ffmpeg-8.0.1.tar.xz
cd ffmpeg-8.0.1
./configure [see configuration above]
make -j$(sysctl -n hw.ncpu)
```

### Option 2: Via Homebrew
```bash
brew install --build-from-source ffmpeg
# Source will be in: /Library/Caches/Homebrew/downloads/
```

### Option 3: Git Repository
```bash
git clone https://git.ffmpeg.org/ffmpeg.git
cd ffmpeg
git checkout n8.0.1
```

## License Compliance

**GPL Requirements Met:**
- ✅ Source code available (link to official ffmpeg.org releases)
- ✅ Build configuration documented (this manifest)
- ✅ License text provided (GPL-2.0.txt)
- ✅ 3-year availability commitment

**Important**: The Underbar.app itself remains under proprietary license. Only the bundled FFmpeg binary and its dependencies are GPL-licensed. FFmpeg is invoked via CLI (separate process), no linking occurs.

## Questions

For FFmpeg-specific questions:
- FFmpeg Official: https://ffmpeg.org
- FFmpeg Community: https://trac.ffmpeg.org

For Underbar GPL compliance questions:
- Email: opensource@underbar.app
- This site: https://oss.underbar.app

---

Last Updated: November 2025
Maintained by: Underbar Team