Skip to main content

Standardize Dolby Vision

FFmpeg Builder: Standardize Dolby Vision

Extracts Dolby Vision dynamic metadata (RPU) from the source video and injects it into your encoded HEVC video stream, converting it to Profile 8.1 for maximum playback compatibility across smart TVs and media players.

  • Profile 8.x: Left untouched and preserved.
  • Profiles 5 & 7: Converted to Profile 8.1 (using dovi_tool --mode 2), making the output compatible with players like Apple TV, Fire TV, and native TV apps.
warning

The working file must be an HEVC video stream inside an MKV container. Ensure a Remux to MKV node precedes this element if necessary.

Remove HDR10+

Removes HDR10+ metadata during the injection process. Enable this if your playback device experiences black screen issues when playing files containing both Dolby Vision and HDR10+ metadata.

Use Crop Fix

Applies dovi_tool --crop to fix invalid or mismatched crop metadata. Only enable this if your source file has incorrect letterbox/crop parameters that cause visual distortion.

Tool Requirements

The required tools (dovi_tool, mkvmerge, mkvextract, and mkvinfo) are included automatically on:

  • Docker official images
  • Windows installations

Bare-Metal Linux & macOS

If your node is running directly on Linux or macOS outside of Docker, install these tools manually on the host and define their executable paths in the Variables section of that Agent's settings page:

  • dovi_tool
  • mkvmerge
  • mkvextract
  • mkvinfo
note

Each variable name on the Agent must match the tool name exactly (e.g., create an Agent variable named dovi_tool pointing to its executable path).

Outputs

  1. Dolby Vision metadata was successfully converted and injected into the stream.
  2. No standardization required (source file is not HEVC, does not contain Dolby Vision, or is already Profile 8).