GitHub Repository
This is the documentation for dovi_convert. For source code, releases, and issue tracking, visit the GitHub repository.
Why convert?
Many popular devices - including Apple TV 4K, Nvidia Shield, Zidoo players, and Plex clients - cannot process the Enhancement Layer in Profile 7 files. Without proper handling, these devices fall back to HDR10, losing Dolby Vision benefits entirely. Converting to Profile 8.1 strips the Enhancement Layer while preserving the dynamic metadata (RPU), giving you a file that works on virtually any Dolby Vision-capable device.Not every Profile 7 file should be converted. Some use the Enhancement Layer for brightness expansion - converting these causes visual issues. dovi_convert analyzes files before conversion and warns you when conversion is risky.
What you need to know
Before using dovi_convert, you should understand what it does and when conversion is appropriate.Before You Start
Understand the technical background, caveats, and device-specific considerations
FEL Types Explained
Learn about MEL, Simple FEL, and Complex FEL - and why it matters
Platform support
dovi_convert runs on:- macOS (tested on macOS 26)
- Linux (any modern distribution)
- Windows (via WSL)
- Docker (with web terminal access)
The conversion process does not re-encode video. Your CPU only needs to handle metadata extraction and remuxing - no powerful hardware required.
Installation
Terminal / Shell
Install directly on macOS, Linux, or Windows (WSL)
Docker
Run in a container with a web-based terminal