skills.rest
damionrashford
damionrashfordCOMMUNITY
Explore all skills by this author →
GitHub

ffmpeg-hdr-color

Convert HDR video to SDR with FFmpeg tone-mapping and color-space conversions.

15|4|Updated Apr 18, 2026
Search Tags:#ffmpeg#hdr#tonemap#colorspace#hdr10#hlg#dolby-vision
One-click install
npx skills add https://github.com/damionrashford/media-os --skill ffmpeg-hdr-color
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ffmpeg-hdr-color
Source: https://github.com/damionrashford/media-os/tree/main/skills/ffmpeg-hdr-color
Command: npx skills add https://github.com/damionrashford/media-os --skill ffmpeg-hdr-color

SYSTEM DOCUMENTATION & REQUIREMENTS

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

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.

Frequently Asked Questions about ffmpeg-hdr-color

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

FAQPage Schema
How do I convert HDR10 video to SDR using FFmpeg?▼

Convert HDR10 video to SDR using FFmpeg by applying tone-mapping and color-space conversions, transitioning BT.2020 primaries to BT.709 and PQ transfer to gamma 2.4 to ensure correct SDR delivery and compliant metadata.

Can I convert HLG content to SDR for web streaming with FFmpeg?▼

Yes, you can convert HLG content to SDR for web streaming by applying FFmpeg tone-mapping with linearization and color-space transitions to produce SDR-compliant proxies with correct color tags.

How do I handle Dolby Vision video when converting to SDR?▼

When converting Dolby Vision video to SDR, you can produce SDR proxies using FFmpeg tone-mapping, with notes for handling DV content when full DV decoding is not available during the color-space conversion process.

Why does my HDR video look washed out on SDR devices?▼

HDR video looks washed out on SDR devices due to missing tone-mapping and color-space handling, requiring conversions from BT.2020 to BT.709 and PQ to gamma 2.4 for proper SDR playback.

What is the best way to generate SDR archival proxies from HDR sources?▼

The best way to generate SDR archival proxies from HDR sources is a unified FFmpeg workflow that applies tone-mapping using FFmpeg tonemap or libplacebo, enforcing proper encoding parameters and SDR-compliant metadata.

Does FFmpeg tonemap support linearization for color-space transitions?▼

Yes, FFmpeg tonemap supports linearization for color-space transitions, applying careful conversions from HDR formats like HDR10 and HLG to SDR while maintaining proper color primaries and transfer characteristics.

Related Skills

Explore More Software Engineering Skills→
damionrashforddamionrashford
15

workflow-hdr

Automates end-to-end HDR authoring across HDR10, Dolby Vision, HLG formats with ffmpeg and OCIO/ACES workflows.

Community
Advanced
aeonbridgeaeonbridge

evolution-api

Automate WhatsApp messaging integrations and multi-service workflows via RESTful APIs and webhooks.

Official
Advanced
overviewlabsoverviewlabs

ascii-video

Convert input media into colored ASCII video using a modular production pipeline.

Community
Advanced
JosiahSiegelJosiahSiegel
51

ffmpeg-color-grading-chromakey

Remove green screens and apply color grading with FFmpeg.

Community
Advanced