build(hwaccel): add libva 2.22.0 for VA-API backend

- Add libva library definition with libdrm dependency
- Patch meson.build to build static library (upstream only supports shared)
- Enable vaapi FFmpeg configure flag via FFmpegEnables
- Disable X11/GLX/Wayland backends for minimal headless build
- Link both libva and libva-drm static libraries

Provides VA-API child device support required by QSV hwcontext on Linux.

Author: flexiondotorg

README.md

@@ -15,7 +15,7 @@ Build once, deploy anywhere. No hunting for system FFmpeg. No version mismatches
 - **FFmpeg 8.0.1** - Latest release with AV1, H.265, H.264, VP8/9
 - **Truly static** - Builds into your binary (just needs system `m` and `stdc++` libraries)
 - **Cross-platform** - Linux and macOS (arm64, amd64)
-- **Hardware acceleration** - NVENC/NVDEC, VideoToolbox, Vulkan and QuickSync support
+- **Hardware acceleration** - NVENC/NVDEC, QuickSync, VA-API, VideoToolbox, and Vulkan support
 - **GPL build** - x264, x265, and all the good codecs included
 - **Auto-generated** - Thin, predictable bindings directly from FFmpeg headers
 - **Preserved documentation** - Original FFmpeg comments in your IDE
@@ -50,7 +50,7 @@ ffmpeg-statigo provides a **curated FFmpeg static library** focused on the core
 
 - **Decoders**: All contemporary formats (H.264, H.265, AV1, VP8/9, Opus, AAC, MP3)
 - **Encoders**: Modern codecs for streaming and transcoding (x264, x265, dav1d, rav1e, vpx, lame, opus)
-- **Hardware acceleration**: NVENC, QuickSync, VideoToolbox, Vulkan Video
+- **Hardware acceleration**: NVENC, QuickSync, VA-API, VideoToolbox, Vulkan Video
 - **Containers**: MP4, MKV, WebM, DASH, HLS, and all major formats
 - **Filters**: Video scaling, colour conversion, audio resampling, and processing filters
 - **Streaming protocols**: RTMP, SRT, HLS, DASH
@@ -86,9 +86,10 @@ If you need complete FFmpeg with all filters, use the official FFmpeg distributi
 | FFmpeg           | 8.0.1       | A complete, cross-platform solution to record, convert and stream audio and video  |
 | dav1d            | 1.5.2       | AV1 cross-platform decoder, open-source, and focused on speed, size and correctness|
 | glslang          | 15.4.0      | Khronos-reference front end for GLSL/ESSL and a SPIR-V generator                   |
-| libdrm           | 2.4.129     | Direct Rendering Manager library and headers                                       |
+| libdrm           | 2.4.129     | Direct Rendering Manager library and headers (*Linux only*)                        |
 | libiconv         | 1.18        | A character set conversion library (*macOS only*)                                  |
 | libsrt           | 1.5.5-rc.0a | A transport protocol for ultra low latency live video and audio streaming          |
+| libva            | 2.22.0      | An implementation for VA-API (Video Acceleration API) (*Linux only*)               |
 | libvpl           | 2.15.0      | Intel Video Processing Library (Intel VPL) API (*Linux only*)                      |
 | libvpx           | 1.15.2      | High-quality, open video format for the web that's freely available to everyone    |
 | libwebp          | 1.6.0       | A modern image format providing superior lossless and lossy compression            |
@@ -112,16 +113,16 @@ Details of codecs, muxers and parsers available in enable in the static ffmpeg l
 
 ### Hardware Acceleration Support Matrix
 
-| Codec          | NVENC (Linux)    | QuickSync (Linux) | VideoToolbox (macOS) | Vulkan Video (Cross-platform) |
-|----------------|------------------|-------------------|----------------------|-------------------------------|
-| **AV1**        | ✅ Encode/Decode | ✅ Encode/Decode  | ☑️ Decode            | ✅ Encode/Decode              |
-| **H.266/VVC**  | ❌               | ☑️ Decode         | ❌                   | ☑️ Decode                     |
-| **H.265/HEVC** | ✅ Encode/Decode | ✅ Encode/Decode  | ✅ Encode/Decode     | ✅ Encode/Decode              |
-| **H.264/AVC**  | ✅ Encode/Decode | ✅ Encode/Decode  | ✅ Encode/Decode     | ✅ Encode/Decode              |
-| **VP9**        | ✅ Encode/Decode | ✅ Encode/Decode  | ❌                   | ☑️ Decode                     |
-| **VP8**        | ☑️ Dec️ode        | ☑️ Decode         | ❌                   | ❌                            |
-| **MPEG-2**     | ☑️ Decode        | ✅ Encode/Decode  | ❌                   | ❌                            |
-| **JPEG/MJPEG** | ☑️ Decode        | ✅ Encode/Decode  | ❌                   | ❌                            |
+| Codec          | NVENC (Linux)    | VA-API (Linux)    | QuickSync (Linux) | VideoToolbox (macOS) | Vulkan Video (Cross-platform) |
+|----------------|------------------|-------------------|-------------------|----------------------|-------------------------------|
+| **AV1**        | ✅ Encode/Decode | ☑️ Encode         | ✅ Encode/Decode  | ☑️ Decode            | ✅ Encode/Decode              |
+| **H.266/VVC**  | ❌               | ❌                | ☑️ Decode         | ❌                   | ☑️ Decode                     |
+| **H.265/HEVC** | ✅ Encode/Decode | ☑️ Encode         | ✅ Encode/Decode  | ✅ Encode/Decode     | ✅ Encode/Decode              |
+| **H.264/AVC**  | ✅ Encode/Decode | ☑️ Encode         | ✅ Encode/Decode  | ✅ Encode/Decode     | ✅ Encode/Decode              |
+| **VP9**        | ✅ Encode/Decode | ☑️ Encode         | ✅ Encode/Decode  | ❌                   | ☑️ Decode                     |
+| **VP8**        | ☑️ Decode        | ☑️ Encode         | ☑️ Decode         | ❌                   | ❌                            |
+| **MPEG-2**     | ☑️ Decode        | ☑️ Encode         | ✅ Encode/Decode  | ❌                   | ❌                            |
+| **MJPEG**      | ☑️ Decode        | ☑️ Encode         | ✅ Encode/Decode  | ❌                   | ❌                            |
 
 ### Capabilities
 
@@ -132,7 +133,12 @@ Details of codecs, muxers and parsers available in enable in the static ffmpeg l
   - Encoding HEVC 10-bit - Pascal and newer
   - Decoding AV1 8/10-bit - Ampere and newer
   - Encoding AV1 8/10-bit - Ada Lovelace and newer
-- **QuickSync (QSV)**: Requires Intel CPU (6th gen Skylake+) or Intel Arc GPU. Uses libvpl/oneVPL dispatcher.
+- **VA-API**: Video Acceleration API for Intel, AMD, and NVIDIA (via `nvidia-vaapi-driver`) GPUs on Linux. Provides hardware encoding; decoding uses FFmpeg's hwaccel framework.
+  - Encoding H.264, HEVC, AV1, VP8, VP9, MPEG-2, MJPEG - Hardware dependent
+  - Intel: Use `iHD` driver (intel-media-driver) for broadest codec support
+  - AMD: Use `radeonsi` driver (Mesa) for RDNA/GCN GPUs
+  - NVIDIA: Use `nvidia` driver (nvidia-vaapi-driver) which translates to NVENC
+- **QuickSync (QSV)**: Requires Intel CPU (11th gen Tiger Lake+) or Intel Arc GPU. Uses libvpl/oneVPL dispatcher. Older Intel CPUs (6th-10th gen) should use VA-API instead.
   - Decoding & Encoding H.264 8-bit - Any Intel GPU that supports Quick Sync Video
   - Decoding & Encoding HEVC 8-bit - Gen 9 Skylake (6th Gen Core) and newer
   - Decoding & Encoding HEVC 10-bit - Gen 9.5 Kaby Lake (7th Gen Core), Apollo Lake, Gemini Lake (Pentium and Celeron) and newer

flake.nix

@@ -57,7 +57,7 @@
               # Hardware acceleration runtime (Linux only)
               vulkan-loader # Required for Vulkan accelerated encoders
               intel-media-driver # VA-API driver for Intel GPUs (iHD_drv_video.so)
-              vpl-gpu-rt # oneVPL runtime for Intel GPUs (QSV backend)
+              vpl-gpu-rt # oneVPL runtime for 11th gen+ Intel (Tiger Lake+) QSV
             ];
 
           # Environment for go-clang CGO compilation and hardware acceleration
@@ -82,7 +82,23 @@
             # Intel media driver and oneVPL runtime for QuickSync
             export LD_LIBRARY_PATH="${pkgs.intel-media-driver}/lib:$LD_LIBRARY_PATH"
             export LD_LIBRARY_PATH="${pkgs.vpl-gpu-rt}/lib:$LD_LIBRARY_PATH"
+            # oneVPL search path for QSV (11th gen+ Intel only)
             export ONEVPL_SEARCH_PATH="${pkgs.vpl-gpu-rt}/lib"
+            # VA-API driver discovery for libva
+            # Use system drivers if available, fall back to nix package for Intel
+            if [ -d "/run/opengl-driver/lib/dri" ]; then
+              export LIBVA_DRIVERS_PATH="/run/opengl-driver/lib/dri"
+            fi
+            # Auto-detect VA-API driver based on GPU vendor (prefer Intel for VA-API)
+            if lspci -d ::0300 2>/dev/null | grep -qi intel; then
+              export LIBVA_DRIVER_NAME="iHD"
+              # Ensure Intel driver path is set even without system drivers
+              export LIBVA_DRIVERS_PATH="${pkgs.intel-media-driver}/lib/dri:''${LIBVA_DRIVERS_PATH:-}"
+            elif lspci -d ::0300 2>/dev/null | grep -qi amd; then
+              export LIBVA_DRIVER_NAME="radeonsi"
+            elif lspci -d ::0300 2>/dev/null | grep -qi nvidia; then
+              export LIBVA_DRIVER_NAME="nvidia"
+            fi
 
             # Vulkan ICD discovery: tell vulkan-loader where to find GPU drivers
             # NixOS installs ICDs under /run/opengl-driver/share/vulkan/icd.d/

internal/builder/ffmpeg_args.go

@@ -360,32 +360,33 @@ func FFmpegArgsCommon(os string) []string {
 		"--disable-encoder=h263",
 	}
 
-	// Linux-specific hardware acceleration (NVENC, CUVID, QuickSync)
+	// Linux-specific hardware acceleration (NVENC, CUVID, QuickSync, VA-API)
 	if os == "linux" {
 		args = append(args,
 			// AV1 hardware acceleration
-			"--enable-encoder=av1_nvenc,av1_qsv",
+			"--enable-encoder=av1_nvenc,av1_qsv,av1_vaapi",
 			"--enable-decoder=av1_cuvid,av1_qsv",
 			// H.264 hardware acceleration
-			"--enable-encoder=h264_nvenc,h264_qsv",
+			"--enable-encoder=h264_nvenc,h264_qsv,h264_vaapi",
 			"--enable-decoder=h264_cuvid,h264_qsv",
 			// H.265 hardware acceleration
-			"--enable-encoder=hevc_nvenc,hevc_qsv",
+			"--enable-encoder=hevc_nvenc,hevc_qsv,hevc_vaapi",
 			"--enable-decoder=hevc_cuvid,hevc_qsv",
 			// MJPEG hardware acceleration
-			"--enable-encoder=mjpeg_qsv",
+			"--enable-encoder=mjpeg_qsv,mjpeg_vaapi",
 			"--enable-decoder=mjpeg_cuvid,mjpeg_qsv",
 			// MPEG-2 hardware acceleration
-			"--enable-encoder=mpeg2_qsv",
+			"--enable-encoder=mpeg2_qsv,mpeg2_vaapi",
 			"--enable-decoder=mpeg2_cuvid,mpeg2_qsv",
 			// MPEG-4 Part 2 hardware acceleration
 			"--enable-decoder=mpeg4_cuvid",
 			// VC-1 hardware acceleration
 			"--enable-decoder=vc1_cuvid,vc1_qsv",
 			// VP8 hardware acceleration
+			"--enable-encoder=vp8_vaapi",
 			"--enable-decoder=vp8_cuvid,vp8_qsv",
 			// VP9 hardware acceleration
-			"--enable-encoder=vp9_qsv",
+			"--enable-encoder=vp9_qsv,vp9_vaapi",
 			"--enable-decoder=vp9_cuvid,vp9_qsv",
 			// VVC hardware acceleration
 			"--enable-decoder=vvc_qsv",

internal/builder/libraries.go

@@ -27,6 +27,7 @@ var allLibraryDefinitions = []*Library{
 
 	// Hardware acceleration
 	libdrm,
+	libva,
 	libvpl,
 	nvcodecheaders,
 	vulkanheaders,
@@ -320,6 +321,46 @@ var libdrm = &Library{
 	LinkLibs: []string{"libdrm"},
 }
 
+// libva - Video Acceleration API (Linux only, provides VA-API backend for QSV)
+var libva = &Library{
+	Name:          "libva",
+	URL:           "https://github.com/intel/libva/releases/download/2.22.0/libva-2.22.0.tar.bz2",
+	Platform:      []string{"linux"},
+	Dependencies:  []*Library{libdrm},
+	FFmpegEnables: []string{"vaapi"},
+	BuildSystem:   &MesonBuild{},
+	ConfigureArgs: func(os string) []string {
+		return []string{
+			// Note: -Ddefault_library=static is added automatically by MesonBuild
+			"-Dwith_x11=no",
+			"-Dwith_glx=no",
+			"-Dwith_wayland=no",
+			"-Dwith_win32=no",
+			"-Dwith_legacy=",
+			"-Denable_docs=false",
+		}
+	},
+	PostExtract: func(srcPath string) error {
+		// Patch va/meson.build to use library() instead of shared_library()
+		// This allows respecting the default_library=static option
+		mesonBuild := filepath.Join(srcPath, "va", "meson.build")
+		content, err := os.ReadFile(mesonBuild)
+		if err != nil {
+			return fmt.Errorf("failed to read va/meson.build: %w", err)
+		}
+
+		// Replace shared_library with library (respects default_library option)
+		patched := strings.ReplaceAll(string(content), "shared_library(", "library(")
+
+		if err := os.WriteFile(mesonBuild, []byte(patched), 0644); err != nil {
+			return fmt.Errorf("failed to write patched va/meson.build: %w", err)
+		}
+
+		return nil
+	},
+	LinkLibs: []string{"libva", "libva-drm"},
+}
+
 // libvpl - Intel VPL/oneVPL headers (Linux only, for QuickSync)
 var libvpl = &Library{
 	Name:          "libvpl",