HDR Toys

A set of color conversion shaders for mpv-player (gpu-next).

R	G	B

For more detailed information, please visit the wiki.

Getting Started

1. Download hdr-toys.zip, extract it.
2. Copy the shaders, scripts, and hdr-toys.conf files to your mpv config folder.
3. Add include=~~/hdr-toys.conf to your mpv.conf.

FAQ

• Shader not working or looks incorrect.

  This set of shaders is specifically designed for use with vo=gpu-next. Make sure NOT to set target-peak, icc-profile, or similar options in mpv.conf.

  For a complete configuration example, check out natural-harmonia-gropius/mpv-config.

  If you've confirmed these settings and the problem persists, please submit an issue.

• Video always appears too dark or too bright.

  This issue arises from the inability to determine the reference white of the video, which is unfortunately not included in the metadata.

  Shaders' default reference white is 203.

  However, for PQ, it mostly 100. It can be set to 100 by uncomment (remove #) the following line in hdr-toys.conf.

  glsl-shader-opts=reference_white=100

  To adjust it at runtime, add the following lines to input.conf.

  n   set glsl-shader-opts reference_white=100
  m   set glsl-shader-opts reference_white=203

• UI/OSD looks washed out.

  To ensure the video input meets the standards, I use a little trick by setting target-prim and target-trc to match the input values. As a side effect, the OSD appears washed out, I currently have no solution.

• I'm not using BT.709 display.

  Replace all gamut-mapping/* lines in hdr-toys.conf with gamut-mapping/clip.glsl. Then modify the #define to * in clip.glsl to match your display.

• What does hdr-toys.js do?

  this provides a way to indirectly pass the necessary information using the glsl-shader-opts.

  • the number of frames for 1/3 second, for reduce flickering.

• I don't use mpv, can I use these shaders?

  These shaders use mpv .hook syntax, which requires libplacebo for execution. ffmpeg and VLC should be able to use. In theory, porting to other shader languages is very feasible.