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.

• I feel the video always looks too dark.

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

  To adjust the reference white, add the following lines to input.conf. Press n when you feel so, and press m to restore to the default.

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

  Note that, due to a limitation in mpv, only parameters changed after the shader is applied will take effect. Therefore, setting glsl-shader-opts=reference_white=100 in mpv.conf will not work.

• 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 inevitably appears washed out.

• 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.