Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/natural-harmonia-gropius/hdr-toys
A set of color conversion shaders.
https://github.com/natural-harmonia-gropius/hdr-toys
color-conversion color-management gamut-mapping glsl mpv shader tone-mapping
Last synced: 2 months ago
JSON representation
A set of color conversion shaders.
- Host: GitHub
- URL: https://github.com/natural-harmonia-gropius/hdr-toys
- Owner: natural-harmonia-gropius
- License: mit
- Created: 2023-02-09T14:52:50.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-11-19T10:55:19.000Z (2 months ago)
- Last Synced: 2024-11-19T12:03:13.555Z (2 months ago)
- Topics: color-conversion, color-management, gamut-mapping, glsl, mpv, shader, tone-mapping
- Language: GLSL
- Homepage:
- Size: 1.47 MB
- Stars: 122
- Watchers: 7
- Forks: 1
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mpv - hdr-toys - Componentized Rec.2100 to Rec.709 conversion shader. (Other)
README
# HDR Toys
A set of color conversion shaders for mpv-player (gpu-next).
| R | G | B |
| -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
|  |  |  |
For more detailed information, please visit the [wiki](https://github.com/natural-harmonia-gropius/hdr-toys/wiki).
## Getting Started
1. Download [hdr-toys.zip](https://github.com/natural-harmonia-gropius/hdr-toys/archive/refs/heads/master.zip), extract it.
2. Copy the `shaders`, `scripts`, and `hdr-toys.conf` files to your [mpv config folder](https://mpv.io/manual/master/#configuration-files).
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**](https://mpv.io/manual/master/#video-output-drivers-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](https://github.com/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` and `target-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](https://mpv.io/manual/master/#options-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`. Press `n` when you feel so, and press `m` to restore to the default.
```ini
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` in `mpv.conf` will not work.
- **I'm not using BT.709 display.**
Replace all `gamut-mapping/*` lines with `gamut-mapping/clip.glsl`. Then modify the `#define to *` in `clip.glsl` to match your display.
- **I don't use mpv, can I use these shaders?**
These shaders use [mpv .hook syntax](https://libplacebo.org/custom-shaders/), which requires `libplacebo` for execution. ffmpeg and VLC should be able to use. In theory, porting to other shader languages is also very feasible.