Introduction
If HDR video looks washed out, too dark, or inconsistent in mpv media player, the problem is usually a misunderstanding of how HDR actually works.
This mpv HDR guide explains HDR10, HDR10+, and Dolby Vision in practical terms, how mpv handles them internally, and why many HDR setups fail even with “correct” configurations. The goal is not just to fix playback issues, but to give you a clear mental model so you can predict how HDR will behave on your system.
If you’re looking for a working configuration, see the Best mpv Config 2026 guide. If your platform differs (Linux, Nvidia quirks, or QLED behavior), use the mpv setup guide addendum.
What HDR Actually Is (and Why It Breaks)
HDR (High Dynamic Range) is not just “brighter video.” It expands the range between the darkest and brightest parts of an image.
The key differences from SDR:
- Higher peak brightness
- Better highlight detail
- Wider color gamut
- Different transfer functions (PQ / HLG)
The problem: HDR only works correctly if every part of the chain agrees.
That chain includes:
- the video file
- the player
- the GPU
- the operating system
- the display
If any part misinterprets the signal, the result is:
- washed-out colors
- crushed highlights
- overly dark scenes
HDR Formats Explained
HDR10 (Baseline HDR)
- Static metadata (one set of brightness values for the entire video)
- Most common format
- Works everywhere
Limitation: cannot adapt scene-by-scene
HDR10+ (Dynamic HDR)
- Scene-by-scene metadata
- Improves brightness and contrast dynamically
Supported well by modern pipelines including libplacebo via gpu-next
Dolby Vision
- Dynamic metadata + proprietary processing
- Multiple profiles (5, 7, 8, 9)
Important reality:
mpv media player does NOT output native Dolby Vision.
But:
- it can read and use Dolby Vision metadata
- it can apply better tone mapping decisions based on it
How mpv Handles HDR (This Is Where It Wins)
Modern mpv uses:
vo=gpu-next- powered by libplacebo
This gives it three key capabilities:
1. Tone Mapping Control
mpv can map HDR → display space intelligently instead of blindly clipping.
2. Metadata Awareness
mpv can:
- use HDR10 static metadata
- respond to HDR10+ dynamic metadata
- interpret Dolby Vision metadata (non-native output)
3. Output Flexibility
mpv can:
- keep desktop SDR
- switch to HDR only when needed
- adjust output behavior dynamically
The 3 Most Common HDR Problems (and Why They Happen)
Washed-Out HDR
Symptoms:
- gray blacks
- low contrast
Cause:
- HDR content displayed as SDR
- incorrect output signaling
HDR Too Dark
Symptoms:
- dim image
- lost shadow detail
Cause:
- incorrect tone mapping
- mismatch between content peak brightness and display capability
Inconsistent Brightness
Symptoms:
- scenes vary wildly in brightness
Cause:
- differences between:
- HDR10 (static)
- HDR10+ (dynamic)
- Dolby Vision metadata
The Correct Mental Model
HDR is not a toggle.
It is a negotiation between systems.
Your final image depends on:
- source metadata
- mpv’s interpretation
- GPU pipeline
- OS HDR behavior
- display capabilities
If you treat HDR like a simple setting, you will get inconsistent results. If you treat it like a pipeline, you can control it.
Recommended Approach for mpv (2026)
For consistent HDR behavior:
- Use
gpu-next - Keep desktop in SDR
- Enable HDR only for HDR content
- Use metadata-aware profiles (HDR10+, Dolby Vision-aware)
- Avoid forcing global HDR
For a full working setup:
- See Best mpv Config 2026
- For platform differences: mpv Setup Guide 2026 Addendum
- For Jellyfin users: Jellyfin MPV Shim Guide
mpv vs madVR (Quick Comparison)
| Feature | mpv (gpu-next) | madVR |
|---|---|---|
| HDR handling | Modern, flexible | Very mature |
| Dolby Vision | Metadata-aware only | Limited |
| Cross-platform | Yes | No (Windows only) |
| Config complexity | Medium | High |
mpv’s strength is flexibility and correctness, not presets.
FAQ (High-Intent Questions)
Does mpv support Dolby Vision?
Not natively for output, but it can use Dolby Vision metadata for better tone mapping.
Is HDR10+ better than Dolby Vision?
Not strictly. Both use dynamic metadata, but Dolby Vision is proprietary and more widely adopted in streaming.
Should I enable Windows HDR all the time?
No. SDR desktop + HDR only when needed is usually the better approach.
Why does HDR look different in VLC?
Different players use different tone mapping strategies and may ignore metadata.
Final Thoughts
The best HDR setup is not the one with the most settings.
It is the one that:
- respects how HDR actually works
- uses metadata correctly
- aligns the entire playback chain
If you understand that, mpv becomes one of the most powerful HDR playback tools available.