ffmpeg-ocio-colorpro

Apply OCIO color transforms to video with FFmpeg and ACES workflows.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a unified workflow to perform color-management transformations for video using FFmpeg and OpenColorIO, enabling precise ACES workflows, LUT baking, and ICC profile handling.

Core Features & Use Cases

  • OCIO-driven transforms: apply full OCIO configuration for accurate camera/log to display-space mapping, including Input/Output Transforms and Look Modifications.
  • ACES workflow support: convert between ACES spaces (ACES2065-1, ACEScc, ACEScct) and common display spaces (Rec.709, sRGB, DCI-P3, HDR PQ/HLG).
  • ICC embedding & LUT baking: embed ICC profiles into outputs via iccgen, and bake LUTs with ociobake when FFmpeg lacks libOpenColorIO.
  • CLI-driven control with fallbacks: provides subcommands (check, transform, aces-to-rec709, aces-to-dcip3, bake-lut, attach-icc) with config-path and verbose options for robust pipelines.

Quick Start

Run colorpro check to verify FFmpeg OCIO support, then run colorpro transform with a sample input video to apply an OCIO pinput/poutput conversion.

Frequently Asked Questions about ffmpeg-ocio-colorpro

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

FAQPage Schema
How do I apply ACES color transforms to video using FFmpeg?

You apply ACES color transforms to video in FFmpeg by using OpenColorIO configurations to map between ACES spaces like ACES2065-1 and display targets such as Rec.709 or DCI-P3. The CLI provides dedicated aces-to-rec709 and aces-to-dcip3 subcommands for these specific conversions.

Can I bake a LUT with FFmpeg if libOpenColorIO is not available?

You can bake a LUT using ociobake as a fallback when FFmpeg lacks libOpenColorIO support. This allows you to generate the necessary color transform files independently, ensuring accurate color-management pipelines continue to function without direct library integration.

Does FFmpeg support embedding ICC profiles for video output?

FFmpeg supports embedding ICC profiles into video outputs via iccgen. This Skill leverages the attach-icc subcommand to ensure accurate color profiles are included in your delivery files across various mastering scenarios.

What is the best way to check if my FFmpeg build supports OpenColorIO?

The best way to check FFmpeg OpenColorIO support is to run the colorpro check command. This verifies your environment's capabilities and confirms whether you can apply direct OCIO-driven transforms or need to rely on LUT baking fallbacks.

How do I convert video from ACES color spaces to HDR formats?

You convert video from ACES color spaces to HDR formats by applying OpenColorIO transforms that target HDR PQ or HLG display spaces. The CLI handles config-path options to ensure accurate mapping from ACEScc or ACEScct to these high dynamic range outputs.

Why are my FFmpeg OCIO color transforms failing on Rec.709 output?

FFmpeg OCIO color transforms may fail if the correct OCIO configuration path is missing or invalid. Use the config-path option to specify your configuration, and utilize the verbose flag to diagnose pipeline issues or safe fallback behavior.