mhl-suite 1.1.0

Simple MHL verification and sealing tools

mhl-suite

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

• mhlver: one tool to verify them all. This is a wrapper that automatically detects MHL versions (legacy and ASC-MHL) and manages recursive directory verification and reporting. It delegates verification to simple-mhl for legacy files and ascmhl for modern manifests.
• simple-mhl: a modern verification and sealing tool, for legacy MHL files. A successor of the discontinued mhl-tool, it fully supports xxhash64 (both seal and verify), and it features a compliance validator for the XML Schema Definition (XSD) as well as cleaner logs.

🛠️ Dependencies

mhlver integrates the following open-source components:

• Python 3.9+ © 2001-2026 Python Software Foundation (PSF)
• python-xxhash © 2014-2026 Yue Du (BSD-2-Clause)
• lxml © 2004-2026 Stefan Behnel, et al. (BSD-3-Clause)
• ASC-MHL 1.2 © 2022-2026 Academy of Motion Picture Arts and Sciences (MIT)

🚀 Installation

Cross-platform (Recommended)

1. Download and install Python 3.10+.

2. Follow instructions to install uv package manager, or brew install uv if you're on macOS / Linux.

3. Install toolkit:

uv tool install mhl-suite

macOS and Linux (Homebrew)

1. Install Homebrew (if not already installed):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Tap and install:

brew tap lucuma13/dit
brew install mhl-suite

📖 Usage

mhlver

mhlver [options] <path>

Options:
  -d, --datestamp        : Prepend datestamp for reporting
  -s, --xsd-schema-check : Validate XML Schema Definition
  -v, --verbose          : Verbose
  -h, --help             : Show this help message
  --version              : Print version

Note: <path> can be a single file or a directory, or the current directory if left blank.

simple-mhl

simple-mhl <command> [options] <path>

Commands / Options:
  seal              : Seal directory (MHL file will be generated at the root)
    -a, --algorithm : Algorithm: xxhash (default), md5, sha1, xxh128, xxh3_64
    --dont-reseal   : Abort operation if an MHL file already exists at root
  verify            : Verify an MHL file and hash values
  xsd-schema-check  : Validate XML Schema Definition
  -h, --help        : Show this help message
  --version         : Print version