hdr10plus_tool

CLI utility to work with HDR10+ in HEVC files.
Previously named hdr10plus_parser, now it's more than just a parser.

 

Building

Toolchain

The minimum Rust version to build hdr10plus_tool is 1.57.0.

 

Options that apply to the commands:

• --verify Checks if input file contains dynamic metadata.
• --skip-validation Skip profile conformity validation. Invalid metadata is set to profile N/A.

Commands

• extract

  Extracts the HDR10+ metadata from HEVC SEI messages to a JSON file.
  Also calculates the scene information for compatibility with Samsung tools.

  If no output is specified, the file is only parsed partially to verify presence of metadata.

  Examples:

  hdr10plus_tool extract video.hevc -o metadata.json

  ffmpeg -i input.mkv -map 0:v:0 -c copy -vbsf hevc_mp4toannexb -f hevc - | hdr10plus_tool extract -o metadata.json -

  Extract without validating:

  hdr10plus_tool --skip-validation extract video.hevc -o metadata.json

 

• inject

  Interleaves HDR10+ metadata NAL units before slices in an HEVC encoded bitstream.
  --verify has no effect with this command.

  Example:

  hdr10plus_tool inject -i video.hevc -j metadata.json -o injected_output.hevc

 

• remove

  Removes HDR10+ metadata NAL units (or SEI messages) in an HEVC encoded bitstream.
  --verify has no effect with this command.

  Example:

  hdr10plus_tool remove video.hevc -o hdr10plus_removed_output.hevc

  ffmpeg -i input.mkv -map 0:v:0 -c copy -vbsf hevc_mp4toannexb -f hevc - | hdr10plus_tool remove -

 

Sample files

Tears of Steel samples encoded with x265 using --dhdr10-info for tests.

Sample JSON metadata available here: https://bitbucket.org/multicoreware/x265_git/downloads/