Skip to main content

Synopsis

dovi_convert -convert <file> [file2] ... [options]

Description

Converts Dolby Vision Profile 7 MKV files to Profile 8.1. The conversion strips the Enhancement Layer while injecting the RPU (dynamic metadata) into the Base Layer, creating a file compatible with devices that don’t support FEL. You can convert a single file or multiple files at once. Wildcards are supported. The original file is automatically backed up as *.mkv.bak.dovi_convert before conversion.

Arguments

ArgumentRequiredDescription
<file>YesOne or more Profile 7 MKV files. Wildcards supported

Options

OptionDescription
-temp PATHWrite temporary files to a separate directory (improves speed on HDDs/NAS)
-forceOverride Complex FEL safety check and convert anyway
-safeForce Safe Mode (disk extraction). Slower but handles problematic files
-deleteDelete backup file after successful conversion
-debugGenerate dovi_convert_debug.log with detailed tool output
If Standard mode fails (common with Seamless Branching), Safe mode is triggered automatically. You don’t need to manually retry.

Examples

Basic conversion:
dovi_convert -convert "Movie.mkv"
Convert multiple files:
dovi_convert -convert "Movie1.mkv" "Movie2.mkv" "Movie3.mkv"
A summary is displayed at the end showing success/failure counts. Convert using wildcards:
dovi_convert -convert *.mkv
Force conversion on Complex FEL file:
dovi_convert -convert "Movie.mkv" -force
Forcing conversion on Complex FEL files produces incorrect tone mapping. Only use this if you understand and accept the quality loss.
Use Safe Mode:
dovi_convert -convert "Movie.mkv" -safe
Delete backup after conversion:
dovi_convert -convert "Movie.mkv" -delete
This removes your only copy of the original Profile 7 file. Use with caution.
Enable debug logging:
dovi_convert -convert "Movie.mkv" -debug
Use a fast temp directory (for HDDs/NAS):
dovi_convert -convert "Movie.mkv" -temp /mnt/ssd/temp

Conversion Process

  1. Analyzes the file to detect FEL complexity
  2. Creates backup (*.mkv.bak.dovi_convert)
  3. Strips Enhancement Layer from video
  4. Injects RPU metadata into Base Layer
  5. Remuxes everything into new MKV file
  6. Verifies frame count matches
All audio and subtitle tracks are preserved.

See also

  • -scan - Analyze files before conversion
  • -batch - Convert multiple files
  • -cleanup - Remove backup files