# Install dovi_convert with Homebrew

Dolby Vision Profile 7 to 8.1 MKV converter. Version 8.2.0 via Homebrew; verified 2026-06-15.

## Install

```sh
sudo av install brew:dovi_convert
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install dovi_convert
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:dovi_convert
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/dovi_convert>
- **Version:** 8.2.0
- **Source summary:** Dolby Vision Profile 7 to 8.1 MKV converter
- **Homepage:** <https://docs.doviconvert.com>
- **Repository:** <https://github.com/cryptochrome/dovi_convert>
- **Upstream docs:** <https://github.com/cryptochrome/dovi_convert#readme>
- **License:** GPL-3.0-only
- **Source archive:** <https://github.com/cryptochrome/dovi_convert/archive/refs/tags/v8.2.0.tar.gz>
- **Last updated:** 2026-06-15T10:20:15-04:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- dovi_convert (cli)
- dovi_convert (alias)

## Dependencies

- dovi_tool
- ffmpeg
- media-info
- mkvtoolnix
- python@3.14

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 8.2.0
- Package-manager updated: 2026-06-15
- Local data: ok
- Upstream repository: https://github.com/cryptochrome/dovi_convert
- Upstream latest detected: v8.2.0 (current)
## Project history and usage

dovi_convert is a media-library CLI for converting Dolby Vision Profile 7 MKV files to Profile 8.1 for wider playback compatibility. It wraps and coordinates tools such as dovi_tool, FFmpeg, MKVToolNix, and MediaInfo while trying to avoid unsafe conversions.

### Project history

The public GitHub repository was created in December 2025, but the changelog shows a fast-moving tool history around versions 7 and 8. The v7.0.0 release notes describe a complete Python rewrite from an original Bash script, replacing shell utilities such as jq, bc, curl, sed, awk, and grep with Python and core media-tool dependencies.

The project exists because many common streaming devices do not support Dolby Vision Profile 7 enhancement layers. Its README says the tool analyzes files first, converts only what is safe, preserves dynamic metadata, and skips complex FEL cases by default unless the user explicitly forces conversion.

### Adoption history

dovi_convert's adoption is tied to home-theater and media-server users who maintain MKV libraries and want Dolby Vision compatibility on devices such as Apple TV, Shield, and Fire TV-class players. Version 7.3.2 added Homebrew installation, making the tool easier to install on macOS and Linux.

Version 8.0.0 changed the command syntax to `dovi_convert [command] [flags] [files]`, merged batch behavior into the `convert` command, and formalized a more Unix-like CLI. Version 8.2.0 added backup and restore of the Dolby Vision enhancement layer, which made destructive library conversion less risky for users trying to save disk space.

### How it is used

Users run commands such as `dovi_convert scan`, `dovi_convert convert Movie.mkv`, or `dovi_convert convert /path/to/media` to inspect and batch-convert MKV files. The tool depends on Python 3.8+, FFmpeg, MKVToolNix, MediaInfo, and dovi_tool.

The project also ships Docker-oriented workflows with a web terminal, which matters for NAS and media-server environments where users may run conversion jobs next to their media storage.

### Why package nerds care

dovi_convert is package-nerd significant because it turns a fragile multi-tool media workflow into an installable command. The package is less about one codec primitive and more about orchestrating exact versions and behaviors of several external binaries.

Its Homebrew formula is useful because media-library operators often run these workflows from macOS or Linux shells and want dependency detection, repeatable upgrades, and a single named command instead of a personal pile of scripts.

### Timeline

- 2025: Public GitHub repository created.
- 2026: v7.0.0 rewrites the tool in Python from the original Bash script.
- 2026: v7.3.2 adds Homebrew installation.
- 2026: v8.0.0 introduces the new command syntax and unified convert command.
- 2026: v8.2.0 adds backup and restore for the enhancement layer.

### Related projects

- dovi_tool is the core Dolby Vision metadata utility used by dovi_convert.
- FFmpeg, MKVToolNix, and MediaInfo are required media-analysis and container-manipulation tools.
- dovi_scripts is credited by the project as an inspiration and knowledge source.

### Sources

- <https://github.com/cryptochrome/dovi_convert>
- <https://docs.doviconvert.com>
- <https://raw.githubusercontent.com/cryptochrome/dovi_convert/main/CHANGELOG.md>
- <https://api.github.com/repos/cryptochrome/dovi_convert>
- <https://api.github.com/repos/cryptochrome/dovi_convert/releases?per_page=5>
- <https://formulae.brew.sh/formula/dovi_convert>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** dovi_convert
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Media and graphics packages](https://www.automicvault.com/pkg/media-graphics-tools/) - Matched media, image, audio, video, or graphics metadata.
- [Documentation packages](https://www.automicvault.com/pkg/documentation-tools/) - Matched documentation, manual, or publishing metadata.
- [dovi_tool](https://www.automicvault.com/pkg/brew/dovi-tool/) - Runtime dependency declared by Homebrew.
- [ffmpeg](https://www.automicvault.com/pkg/brew/ffmpeg/) - Runtime dependency declared by Homebrew.
- [media-info](https://www.automicvault.com/pkg/brew/media-info/) - Runtime dependency declared by Homebrew.
- [mkvtoolnix](https://www.automicvault.com/pkg/brew/mkvtoolnix/) - Runtime dependency declared by Homebrew.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [mkvtomp4](https://www.automicvault.com/pkg/brew/mkvtomp4/) - Shares av.db curated category or tags: cli, media, mkv, video, video-conversion.
- [gifify](https://www.automicvault.com/pkg/brew/gifify/) - Shares av.db curated category or tags: cli, media, video, video-conversion.
- [mkclean](https://www.automicvault.com/pkg/brew/mkclean/) - Shares av.db curated category or tags: cli, media, mkv, video.
- [animdl](https://www.automicvault.com/pkg/brew/animdl/) - Shares av.db curated category or tags: cli, media, video.
- [bento4](https://www.automicvault.com/pkg/brew/bento4/) - Shares av.db curated category or tags: cli, media, video.
- [ccextractor](https://www.automicvault.com/pkg/brew/ccextractor/) - Shares av.db curated category or tags: cli, media, video.
- [dvanalyzer](https://www.automicvault.com/pkg/brew/dvanalyzer/) - Shares av.db curated category or tags: cli, media, video.

## Combined YAML source

View the package source record on GitHub. [combined/dovi_convert.yml](https://github.com/automic-vault/db/blob/main/combined/dovi_convert.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
