Skip to main content
This guide covers installing dovi_convert on your system without Docker. If you prefer a containerized setup with a web terminal, see the Docker installation instead.

​
Platform Support

dovi_convert runs on:
  • macOS (tested on macOS 26)
  • Linux (any modern distribution with Python 3.8+)
  • Windows (via WSL - Windows Subsystem for Linux)
Windows native support is not available. You must use WSL to run dovi_convert on Windows.

​
Dependencies

Before installing dovi_convert, you need the following tools:
macOS users: You must use the command-line versions of these tools, not the .app bundles.GUI applications like MKVToolNix.app or MediaInfo.app are sandboxed differently and don’t work correctly with dovi_convert. Install via Homebrew or MacPorts instead.

​
Automatic Dependency Installation

When you run dovi_convert, it checks for missing dependencies and offers to install them automatically, using your system’s packet manager. It supports:
  • Homebrew (macOS)
  • apt (Ubuntu, Debian)
  • dnf (Fedora)
  • pacman (Arch Linux)
dovi_tool may not be available in all package managers. If automatic installation fails, download it manually from the dovi_tool GitHub releases.

​
Installation

​
Homebrew

​
Manual

If you don’t have Homebrew, you can manually install it by downloading from Github, making the script executable and moving it into your path:
After installation, run dovi_convert --help to verify everything works. To update, simply repeat the same process.

​
From Source

If you want to stay updated with development changes:
1

Clone the repository

2

Create a symlink

3

Update when needed

​
Verify Installation

Run the help command to confirm dovi_convert is installed correctly:
If any dependencies are missing, the script prompts you to install them.

​
Next Steps

Now that you’ve installed dovi_convert, learn how to use it:

File Scanning

Analyze your files to identify formats and FEL status

File Conversion

Convert individual files or directories to Profile 8.1