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.