ffmpeg-lut-grade

Apply 3D LUTs and HALD CLUTs to video with FFmpeg.

15|4|Updated Apr 18, 2026
One-click install
npx skills add https://github.com/damionrashford/media-os --skill ffmpeg-lut-grade
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ffmpeg-lut-grade
Source: https://github.com/damionrashford/media-os/tree/main/skills/ffmpeg-lut-grade
Command: npx skills add https://github.com/damionrashford/media-os --skill ffmpeg-lut-grade

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill provides a deterministic workflow to apply 3D LUTs (.cube/.3dl) and HALD CLUTs for video color grading using FFmpeg, simplifying consistent looks across clips and projects.

Core Features & Use Cases

  • Apply LUTs from .cube/.3dl files with precise interpolation using ffmpeg's lut3d.
  • Use HALD CLUT PNGs for quick, repeatable color grades that translate between editors and color pipelines.
  • Balance and correct color with tools like colorbalance, colorlevels, selectivecolor, and color space conversions (BT.601 to BT.709) to match VFX and broadcast requirements.
  • Expose an extensible wrapper (scripts/grade.py) to run common grading tasks via subcommands, enabling dry-run and verbose modes for safe experimentation.

Quick Start

Run the grade.py script to apply a LUT to your video by providing an input file, a LUT file, and an output file.

Frequently Asked Questions about ffmpeg-lut-grade

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

FAQPage Schema
How do I apply a 3D LUT to video using FFmpeg?

Apply 3D LUTs to video using FFmpeg by running the grade.py wrapper, which uses the lut3d filter to bake .cube or .3dl files into your footage with precise interpolation for consistent color grades.

Can I use HALD CLUT PNGs for color grading in FFmpeg?

Yes, you can use HALD CLUT PNGs for color grading in FFmpeg to achieve quick, repeatable looks that translate easily between different editors and color pipelines.

What's the best way to convert video from BT.601 to BT.709 color space?

Convert video from BT.601 to BT.709 color spaces using FFmpeg color balancing tools like colorbalance and colorlevels to match VFX and broadcast requirements for consistent editorial output.

Does FFmpeg support dry-run and verbose modes for color grading workflows?

FFmpeg supports safe color grading experimentation through an extensible wrapper exposing dry-run and verbose modes, guarding against common errors while running multiple subcommands.

Why use HALD CLUTs instead of .cube files for video color grading?

HALD CLUTs provide quick, repeatable color grades using PNG files that translate between editors, whereas .cube and .3dl files use lut3d interpolation for standard 3D LUT application.

Can I bake consistent film-look color grades across multiple video clips?

Bake consistent film-look color grades across multiple clips by applying the same 3D LUT or HALD CLUT deterministically, ensuring uniform color balancing and aesthetics throughout your project.