restore

​

Synopsis

dovi_convert restore <file> [options]

​

Description

​

Arguments

​

Options

​

Examples

dovi_convert restore movie.mkv

dovi_convert restore movie.mkv --source /Volumes/Backups/movie.dovi

dovi_convert restore movie.mkv --temp /mnt/ssd/temp

​

Output

Restoring: movie.mkv
  Using backup: movie.dovi
Restoring Profile 7... Done.

Restore completed successfully.
  Restored file: movie.restored.mkv
  Size: 52.33 GB
  Format: Profile 7 (Dolby Vision, Version 1.0, dvhe.07.06, BL+EL+RPU)

​

Restoration Process

1. Locate archive — Finds <filename>.dovi in the same directory, or uses --source
2. Extract Base Layer — Pulls the video stream from the current file
3. Detect format — Checks if the file is Profile 8.1 or HDR10
4. Sanitize — If Profile 8.1, strips the injected RPU to get a clean Base Layer
5. Unpack archive — Extracts the original Enhancement Layer
6. Rebuild — Muxes Base Layer + Enhancement Layer into Profile 7
7. Remux — Combines restored video with original audio and subtitles
8. Verify — Confirms the output is valid Profile 7

​

Error Handling

No backup found.
  Expected: /path/to/movie.dovi
  Hint: Use --source to specify an alternate backup location.

​

Restrictions

• Single file only. There is no batch restore mode.
• Requires matching archive. The .dovi archive must be from the same source file. Using an archive from a different file produces invalid output.

​

See Also

• backup — Create archives for later restoration
• Backup & Restore concept — How archiving works