ffmpeg-hdr-color

What problem does it solve?

HDR content often cannot be played correctly on SDR devices due to missing tone-mapping and color-space handling. This Skill provides a unified FFmpeg-based workflow to convert HDR10/HLG/Dolby Vision to SDR with proper color primaries, transfer characteristics, and metadata.

Core Features & Use Cases

• HDR to SDR tone-mapping using ffmpeg tonemap or libplacebo, with linearization and careful color-space transitions.
• Color primaries and transfer conversions (BT.2020 → BT.709, PQ to gamma 2.4) for web and mobile SDR delivery.
• DoVi/DV content handling notes and how to produce SDR proxies when full DV decoding is not available.
• General use cases include producing SDR masters, streaming proxies, and quick-test SDR deliveries from HDR sources.

Quick Start

Run uv run ${CLAUDE_SKILL_DIR}/scripts/hdrcolor.py detect --input input.mkv to identify HDR type and then run the appropriate hdr-to-sdr or hlg-to-sdr command to produce an SDR output.