HDR Tone Mapping
video-tonemap
Controls how HDR (High Dynamic Range) video content is converted to SDR (Standard Dynamic Range) during encoding.
video-tonemap accepts the following values:
| Value | Behavior |
|---|---|
auto | Automatically detects HDR content and applies tone mapping as needed (default) |
sdr | Forces tone mapping of HDR to SDR regardless of source |
passthrough or hdr | Passes through the HDR signal without conversion |
When an HDR source video is delivered to SDR displays without tone mapping, colors appear washed out or clipped. Setting video-tonemap=sdr ensures consistent visual output across all display types.
Use video-tonemap=passthrough (or hdr) only when delivering to HDR-capable players and displays, and when your source content contains valid HDR metadata.