Skip to main content
dovi_convert automates the conversion of Dolby Vision Profile 7 MKV files (typically UHD Blu-ray rips) into Profile 8.1. This ensures compatibility with media players that don’t support the Profile 7 Enhancement Layer.

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

​
Core Concepts

Once installed, familiarize yourself with the main features:

File Scanning & Analysis

Identify video formats and analyze FEL complexity with scan and inspect

File Conversion

Convert individual files or directories with convert

Backup & Restore

Archive original layers for future restoration (coming soon)