mhl-suite

mhl-suite is a toolkit for sealing and verifying MHL files. It consists of two primary executables:

• mhlver: one tool to verify them all. A wrapper that verifies MHL files recursively in a directory, with optional XSD schema validation and reporting. It delegates to simple-mhl for classic flat MHLs and to ascmhl for ASC-MHL.
• simple-mhl: a modern sealing and verification tool, for classic flat MHL files. A successor of the discontinued mhl-tool and backwards compatible with its manifests - 2 to 5 times faster, full support for standard xxhash64be hashes, XSD schema validation features, cleaner output and structured exit codes.

🚀 Installation

1. Install the uv package manager with the official installer, or:

• macOS: brew install uv
• Windows: winget install astral-sh.uv
• Linux (Debian): apt-get install uv

2. Install the toolkit:

uv tool install mhl-suite

3. Test the installation (if the command is not recognised try uv tool update-shell and restart your terminal):

mhlver --version; simple-mhl --version

📖 Usage examples

Verify MHL files (both classic and ASC-MHL):

mhlver path/to/file.mhl
mhlver path/to/directory/
mhlver                                     # verify current directory

Seal a directory:

simple-mhl seal path/to/directory/
simple-mhl seal -a md5 path/to/directory/   # use MD5 algorithm

Validate XML Schema Definition of a file:

mhlver --xsd-schema-check path/to/file

Run simple-mhl --help and mhlver --help to see the full list of options.