Profile
Back to NewsBack
GitHub Trending 8 min
Reader Mode
CroqueMr/libreelec-CB1: LibreELEC with High Quality Dolby Vision & HDR10+ support for Intel, AMD, Nvidia, and more

CroqueMr/libreelec-CB1: LibreELEC with High Quality Dolby Vision & HDR10+ support for Intel, AMD, Nvidia, and more

LibreELEC × CB1 — Dolby Vision Master Reference. HDR10+, Blu-ray 3D, Disc Menus & More.
Dolby Vision without compromise. Full FEL. Native LLDV. Master Reference precision that surpassed the best dedicated Dolby Vision players in independent testing.

Powered by CB1, an open-source Dolby Vision engine, this x86 build plays everything from SDR to Dolby Vision FEL and UHD Blu-ray ISOs, built to preserve the original image and bring the full disc experience to your screen.

  • Full Dolby Vision playback, including FEL, LLDV, CMv4.0 From streaming encodes to UHD Blu-ray remuxes.
  • The most accurate known 12-bit Dolby Vision player. Master Reference led DMDreview’s tests by a wide margin in precision and fidelity. See the measurements
  • Dolby Vision rendering for HDR10 displays. Full FEL reconstruction and HDR10 calibrated to your display’s peak brightness, black level and gamut.
  • HDR10+ dynamic metadata. Native HDR10+, Dolby Vision to HDR10+ conversion, and HDR10+ scene data for Dolby Vision output.
  • Native playback and conversions. Dolby Vision, HDR10, HDR10+, HLG and SDR for TVs and projectors.
  • Full Blu-ray menus. HDMV and BD-J on Blu-ray and UHD ISOs, with chapters, extras, audio and subtitles.
  • Blu-ray 3D over HDMI. MVC frame packing on compatible systems, plus side-by-side and top-and-bottom.
  • On-the-fly picture controls. Switch circuits, inspect HDMI output and choose separate upscalers for 1080p and above or below 1080p.
R1.0.0 · CB1 1.0

Downloads and release notes · HDMI compatibility · Recommended hardware · Output accuracy · Benchmarks and upscalers · What's next? · Report a bug or suggest a feature

For a fresh installation use the .img.gz image. For an existing installation use the matching LibreELEC .tar update. Press O while a video is playing to see the active input, processing and output, open Quick Switch, or return to the video. Set the default for each input in Settings → Player → Videos. Playback settings

Player Information and Quick Switch

Player Information

Player Information showing Dolby Vision Master Reference, full FEL and TV-led output on the Ryzen 5 7430U</a>

Quick Switch

Quick Switch with Dolby Vision Master Reference active and highlighted</a>

Dolby Vision

Common sources include Profile 5, Profile 7 MEL/FEL, Profile 8.1/8.2/8.4, and Profile 10. Circuit availability also depends on the exact source and output. Playback settings · Circuit versions

| Circuit | Output | What it does | | --- | --- | --- | | Dolby Vision : Master Reference | Dolby Vision, TV-led | State-of-the-art Dolby Vision output with uncompromised precision. | | Dolby Vision : Reference | Dolby Vision, TV-led | Optimized Dolby Vision output with imperceptible quality loss, significantly reducing GPU load. | | Dolby Vision : Adaptive HDR Mapping | Dolby Vision, TV-led | Uses the configured display profile and scene metadata to expand selected highlights and midtones. | | Dolby Vision : LLDV Reference | Dolby Vision, player-led | Maps to the display target read from its Dolby Vision EDID. | | HDR10 : Rendering | HDR10 | Uses source mastering information and scene guidance. | | HDR10 : LLDV Reference conversion | HDR10 | Maps to a manually configured HDR10 target with compatible creative guidance. | | HDR10+ : Conversion | HDR10+ | Reconstructs the image and generates frame-owned dynamic metadata for an HDR10+ display. | | SDR : Conversion | SDR, BT.709 by default | Reconstructs Dolby Vision and maps it to the selected SDR target. | | Kodi : Default | Kodi-selected | Uses Kodi’s original playback and fallback behavior. |

Reference vs Master Reference. Both reconstruct applicable FEL and send the Dolby Vision metadata to the TV for TV-led display mapping. Reference substantially reduces GPU work, with small image differences intended to be imperceptible in normal viewing. Master Reference preserves the highest reconstruction precision with exact source-domain arithmetic and dedicated FEL filters on admitted sources. Processing and metadata · Matched image crops and GPU measurements

HDR10+

| Circuit | Output | What it does | | --- | --- | --- | | HDR10+ : Native | HDR10+ | Preserves the decoded picture and authored dynamic metadata on a compatible HDMI chain. | | Dolby Vision : Rendering | Dolby Vision, TV-led | Preserves the source picture and uses HDR10+ scene statistics to generate Dolby Vision metadata. | | SDR : Conversion | SDR, BT.709 by default | Maps the picture to the independent SDR target using available scene statistics. | | Kodi : Default | HDR10 | Uses the ordinary Kodi HDR path. Select HDR10+ : Native to send the source dynamic metadata. |

HDR10 and HLG

| Source | Circuit | Output | What it does | | --- | --- | --- | --- | | HDR10 | HDR10 : Native | HDR10 | Keeps native HDR10 playback on a compatible display. | | HDR10 | Dolby Vision : Rendering | Dolby Vision, TV-led | Derives Dolby Vision scene metadata through image analysis and a LightGBM model. | | HDR10 | Dolby Vision : Adaptive HDR Mapping | Dolby Vision, TV-led | Combines generated scene metadata with highlight expansion for the configured display. | | HDR10 | SDR : Conversion | SDR, BT.709 by default | Maps the original PQ picture to the selected SDR target. | | HLG | HLG : Native | HLG | Keeps the original HLG signal on a compatible display. | | HLG | Dolby Vision : Rendering | Dolby Vision, TV-led | Normalizes HLG to the BT.2100 reference display before scene analysis and Dolby Vision output. | | HLG | SDR : Conversion | SDR | Maps the original HLG picture to the selected SDR target. |

SDR

| Circuit | Output | What it does | | --- | --- | --- | | Kodi : Default | SDR | Plays the source using Kodi’s SDR path. If the image is enlarged, the selected SDR upscaler can run. |

Native HDMI compatibility

Use a native HDMI port wired to the GPU. DisplayPort and USB-C to HDMI converters are outside this support list.

  • Intel — Integrated graphics on mobile and desktop Core 8th Gen or newer, selected 7th Gen Kaby Lake systems, Core Ultra Series 1/2, and N-series including N100/N150. Dedicated GPUs include Arc A/B and Iris Xe MAX.
  • AMD — Ryzen APUs with Radeon graphics: mobile 2000–6000, 7030/7035/7040/8040 and Ryzen AI 300, plus desktop 2000G/3000G/4000G/5000G/8000G. Dedicated GPUs include Radeon RX 5000/6000/7000 and Vega M. RX 550 support is experimental. RX 9000 awaits physical HDMI validation.
  • NVIDIA (Not recommanded, drivers not perfectly handle) — Dedicated GeForce GTX 10/16 and RTX 20/30/40/50. The Generic image automatically selects the matching driver.
  • Raspberry Pi 5 — TV-led Dolby Vision with output matching CB1 Master Reference at the same settings. dangerouslaser's dedicated build
Full hardware list · HDMI output support by format

Recommended hardware

  • Recommended minimum for native playback up to 4K60 and conversions below 30 fps — AMD Ryzen 5 3500U, Intel N100, or better. Includes full FEL in TV-led Dolby Vision Master Reference
  • LLDV Reference, demanding conversions circuit above 30 fps — AMD Ryzen 3 7330U, Intel Core i3-1315U, or faster graphics.
Future features may be more demanding and will likely require faster hardware.

Both tiers require native HDMI. Performance details

Dolby Vision output accuracy

Independent grayscale comparison of Dolby Vision Master Reference, Oppo/M9201, AM6B+ and Dune

DMDreview’s synthetic grayscale test on LibreELEC R1.0.0 Beta5. Lower is better. Master Reference had the fewest samples differ from the reference in each of the three measured components. Watch the analysis

Benchmarks and upscalers

What's next?

  • BD-J menus — Improve performance and rework how Blu-ray menus are handled.
  • Playback performance — Optimize decoding and rendering across formats, including Dolby Vision FEL and 60 fps content, and Nvidia drivers
  • Bug fixes — Investigate and fix previously unknown bugs reported through GitHub Issues.
  • New features — Add features based on user suggestions.

Found a bug or have a feature suggestion?

For general questions and build discussion, see Contributing.

For bugs and performance problems, open a GitHub issue. I’ll take a look and get back to you as soon as I can.

For new features, send your suggestion privately. Tell me what you’re trying to do and what’s missing today. An email address is required so we can reply and keep you informed about your suggestion.

For a bug report

  1. In Kodi, go to Settings → System → Logging → Enable debug logging.
  2. Reproduce the problem.
  3. Open Settings → LibreELEC → System → Submit Log. Choose Upload latest Kodi log and configs, and view the short URL. If Kodi crashed, upload the latest crash log from the same menu as well.
  4. Paste the short URL shown on screen into your issue. Include the build version, GPU, TV or projector, HDMI chain, source format, selected circuit and steps to reproduce.
  5. Turn debug logging off after you share the log.
More diagnostics

Documentation

Processing and metadata · Algorithms · Blu-ray menus and subtitles · AMD HDMI 3D · Audio · Full documentation index · Licensing and credits

Credits

  • Neutral CM4 blocks, PQ formulas, and Dolby Vision tooling and references from quietvoid’s dovi_tool.
  • Bitmap subtitle controls, CM2.9-to-CM4 selection rules, and read-only Atmos program and EMDF parsing from avdvplus.
  • Blu-ray and UHD Blu-ray menu navigation and BD-J fixes adapted from SamuriHL's CoreELEC work.
  • Blu-ray 3D and stereo-output work by CinemaOne and popcornmix.
  • Global rendering-engine optimizations by dangerouslaser.
  • The three-column Player Information redesign and bug fixing by CorentinB.
  • NVIDIA GeForce GTX 10-series (Pascal) support includes work adapted from LibreELEC Hades by hadesdevls.
  • Passthrough Dialnorm controls adapted from CoreELEC p3i work by pannal.
  • Development assistance from OpenAI GPT-6 Astra, GPT-6.1 Sol.
  • ashlar contributed the idea and part of the code for shader-based CNN upscaling.
  • Thank you to everyone who tests the builds, reports issues, shares logs and samples, and retests fixes. Your feedback helps improve each release.
LibreELEC × CB1 is an unofficial community build made possible by the LibreELEC project. It is independent of Dolby, Intel, AMD, and NVIDIA.

Donate to LibreELEC via Open Collective

Chat with me