build-ffmpeg-with-vmaf

Build FFmpeg against a local libvmaf checkout and run smoke tests.

3|1|Updated May 28, 2026
One-click install
npx skills add https://github.com/VMAFx/vmafx --skill build-ffmpeg-with-vmaf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-ffmpeg-with-vmaf
Source: https://github.com/VMAFx/vmafx/tree/main/.claude/skills/build-ffmpeg-with-vmaf
Command: npx skills add https://github.com/VMAFx/vmafx --skill build-ffmpeg-with-vmaf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the manual friction of integrating a local libvmaf build with FFmpeg, applying any repository patches, and validating that the video quality filters still work end to end.

Core Features & Use Cases

  • FFmpeg Checkout Management: Clones or updates the target FFmpeg revision and keeps the workspace clean and reproducible.
  • Patch Application: Applies any maintained FFmpeg patches in a safe, ordered way before building.
  • Integration Verification: Configures FFmpeg against the local libvmaf artifacts, compiles it, installs it, and runs smoke tests for both the libvmaf and vmaf_pre filters.
  • Use Case: Use this Skill when you need to confirm that a fresh libvmaf change still builds correctly with FFmpeg and produces valid VMAF output in a test run.

Quick Start

Ask the skill to build FFmpeg against your current local libvmaf checkout, apply any available FFmpeg patches, and run the standard VMAF filter smoke tests.

Frequently Asked Questions about build-ffmpeg-with-vmaf

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build FFmpeg with libvmaf integration?

To build FFmpeg with libvmaf, clone or update the target FFmpeg revision, apply repository patches in order, configure against the local libvmaf build, and compile the source code. This process ensures proper integration of the video quality filters.

How can I verify that FFmpeg VMAF filters are working after compilation?

Verify FFmpeg VMAF filters by running libvmaf and vmaf_pre smoke tests after compilation and installation. These tests confirm the video quality filters produce valid VMAF output in a test run end to end.

What environment variables are needed to configure FFmpeg against a local libvmaf build?

Configuring FFmpeg against a local libvmaf build requires scoping the PKG_CONFIG_PATH and LD_LIBRARY_PATH environment variables. These paths ensure the build system correctly locates and links the local libvmaf artifacts during compilation.

Does applying FFmpeg patches require a specific order?

Yes, applying FFmpeg patches requires a safe, ordered application before building. Maintained repository patches must be applied sequentially to ensure the workspace remains clean, reproducible, and correctly configured for the libvmaf integration.

How do I test the vmaf_pre AI filter with a tiny model?

Testing the vmaf_pre AI filter involves optional tiny model detection during the smoke test phase. This detection runs alongside the standard libvmaf filter tests to validate the video quality processing output end to end.