clap-validator (archived)

⚠️ This fork is archived (2026-07-26).

All critical fixes have been merged upstream. Use the official free-audio/clap-validator (v0.4.1+) instead.

Remaining fork-only features (state-context extension, Tier-A extension tests, DAW-lifecycle tests) may be contributed upstream in the future. This repo stays read-only for reference — can be unarchived if needed.

A validator and automatic test suite for CLAP plugins. Clap-validator can automatically test one or more plugins for common bugs and incorrect behavior.

Usage

Simply pass the path to one or more .clap plugins to clap-validator validate to run the validator on those plugins. The --only-failed option can be used to hide the output from all successful and skipped tests. Running clap-validator validate --help lists all available options:

clap-validator validate /path/to/the/plugin.clap
clap-validator validate /path/to/the/plugin.clap --only-failed
clap-validator validate --help

Debugging

clap-validator runs tests in separate processes by default so plugin crashes can be treated as such instead of taking down the validator. If you want to attach a debugger to debug the plugin's behavior during a specific test, you can tell the validator to run the that test in the current process. Use clap-validator list tests to list all available tests.

clap-validator validate --in-process --test-filter <test-case-name> /path/to/the/plugin.clap

Building & Installing

Requires Rust. Build and install:

Install:

cargo install --git https://github.com/LX-Audiolabs/clap-validator --tag v0.3.5 --force

OR download the latest release, then:

cargo install --path .

Or run directly without installing:

cargo run --release -- validate /path/to/the/plugin.clap