Awesome
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
- Download hdr-toys.zip, extract it.
- Copy the
shaders
,scripts
, andhdr-toys.conf
files to your mpv config folder. - Add
include=~~/hdr-toys.conf
to yourmpv.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 inmpv.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.
-
UI/OSD looks washed out.
To ensure the video input meets the standards, I use a little trick by setting
target-prim
andtarget-trc
to match the input values. As a side effect, the OSD inevitably appears washed out. -
What does hdr-toys.js do?
HDR videos generally include metadata with luminance information, but shaders cannot access this data directly.
hdr-toys.js
provides a way to indirectly pass the necessary information using the glsl-shader-opts.It also passes the number of frames for 1/3 second to reduce flickering, helping to smooth out rapid brightness changes.
-
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
. Pressn
when you feel so, and pressm
to restore to the default.n set glsl-shader-opts L_sdr=100 m set glsl-shader-opts L_sdr=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=L_sdr=100
inmpv.conf
will not work. -
I'm not using BT.709 display.
Replace all
gamut-mapping/*
lines withgamut-mapping/clip.glsl
. Then modify the#define to *
inclip.glsl
to match your display. -
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 also very feasible.