hdr-hdr10plus-tool

Orchestrate HDR10+ JSON extraction, injection, removal, editing, and plotting for MKV/HEVC streams.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

HDR10+ metadata handling is complex and error-prone; hdr10plus_tool provides a unified workflow for extracting, injecting, removing, editing, plotting, and baking HDR10+ data into HEVC streams.

Core Features & Use Cases

  • Extract HDR10+ JSON from HEVC/MKV for Samsung-format HDR10+ workflows.
  • Inject HDR10+ into HEVC streams prior to remuxing to ensure per-frame SEI integrity.
  • Remove HDR10+ SEI from a stream while preserving static HDR10 metadata (MaxCLL/MaxFALL/MDCV) and enabling re-encoding or remuxing.
  • Plot per-frame HDR10+ brightness curves for QA and validation.
  • Generate an x265 command that bakes HDR10+ at encode time via --dhdr10-info for end-to-end HDR10+ workflows.

Quick Start

Run hdr10plus.py extract to pull HDR10+ metadata, then optionally edit, plot, or generate an x265-encode command for embedding HDR10+ data.

Frequently Asked Questions about hdr-hdr10plus-tool

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

FAQPage Schema
How do I extract HDR10+ metadata from an MKV file into JSON?

Yes, you can remove HDR10+ SEI metadata from HEVC streams while preserving static HDR10 data like MaxCLL, MaxFALL, and MDCV. This allows you to clean dynamic metadata before re-encoding or remuxing files.

How do I bake HDR10+ metadata into an x265 encode?

HDR10+ metadata handling requires the hdr10plus_tool binary, the Python wrapper hdr10plus.py, and common tooling like mkvmerge, MP4Box, and x265. These tools orchestrate extraction, injection, and encoding workflows.

Can I plot HDR10+ brightness curves for quality assurance?

You can plot per-frame HDR10+ brightness curves from the extracted Samsung-format JSON for QA and validation. This visualizes dynamic metadata variations across the video stream to verify accuracy.

How do I inject HDR10+ metadata back into an HEVC stream?

You can inject HDR10+ metadata into HEVC streams prior to remuxing to ensure per-frame SEI integrity. The workflow uses mkvmerge or MP4Box to embed the edited Samsung-format JSON into the final output.