Skip to main content
The -batch command processes multiple files at once. It recursively scans a directory, identifies all Profile 7 files, and converts them in sequence. This is ideal for processing large media libraries.

How batch processing works

When you run -batch:
  1. Scans the directory recursively for MKV files
  2. Analyzes each file to identify Profile 7 content and FEL status
  3. Displays a summary showing what will be converted
  4. Asks for confirmation before proceeding
  5. Converts eligible files one by one
Non-Profile 7 files are skipped automatically. You don’t need to filter your directory first.

Basic usage

Process all Profile 7 files in the current directory:
dovi_convert -batch

Set recursive depth

Control how deep the scan goes into subdirectories:
dovi_convert -batch 2    # Scan and convert 2 levels deep
dovi_convert -batch 5    # Scan and convert 5 levels deep

Safety behavior

Batch processing follows the same safety rules as single-file conversion:
File typeDefault behavior
MELConverted automatically
Simple FELPauses for confirmation
Complex FELSkipped entirely

Handling Simple FEL files

By default, batch processing stops when it encounters Simple FEL files and asks if you want to include them:
Found 3 Simple FEL files. Include them in this batch? [y/N]
If you say no, the batch continues with only MEL files.

Automation options

Auto-confirm (-y)

Skip the initial confirmation prompt:
dovi_convert -batch -y
The -y flag skips the “Start batch?” prompt but still pauses on Simple FEL files. This prevents accidental processing of files you might want to verify first.

Include Simple FEL (-include-simple)

Treat Simple FEL files the same as MEL - process them without pausing:
dovi_convert -batch -y -include-simple
This combination gives you fully automated processing:
  • -y skips the start confirmation
  • -include-simple skips the Simple FEL confirmation

Force Complex FEL (-force)

Include Complex FEL files in the batch:
dovi_convert -batch -force
Forcing conversion on Complex FEL files produces incorrect results. Use this only if you understand and accept that some files will have incorrect tone mapping.

Permanent deletion (-delete)

Remove original files immediately after each successful conversion, skipping the backup step entirely:
dovi_convert -batch -delete
This is irreversible. Your original Profile 7 files are gone permanently. Only use this if storage space is a concern and you’re confident in the conversion results.
If storage is a concern but you want a safety net, run the batch without -delete, verify your results, then use -cleanup to remove backups selectively.

Batch summary

After scanning, dovi_convert shows a summary:
=== Batch Summary ===
Profile 7 MEL:        12 files
Profile 7 Simple FEL:  3 files
Profile 7 Complex FEL: 1 file (will be skipped)
Other/Ignored:        45 files

Total to convert: 15 files (423 GB)
Proceed? [y/N]
This gives you a chance to review before any changes are made.

Cleaning up backups

After batch processing, you will have .bak.dovi_convert backup files. These are the backups of your original files. If you don’t want to keep them, you can remove them using the -cleanup command.
This is irreversible. Your original Profile 7 files are gone permanently. Only use this if storage space is a concern and you’re confident in the conversion results.

Basic cleanup

Remove backup files in the current directory:
dovi_convert -cleanup

Recursive cleanup

Remove backups from subdirectories:
dovi_convert -cleanup -r

Auto-confirm cleanup

Skip the confirmation prompt:
dovi_convert -cleanup -y
The cleanup command has a safety check: it only deletes backups where the corresponding converted file exists. If you deleted the converted file (maybe it was corrupted), the backup is kept as orphan protection.

Next steps