free-audio /clap-wrapper
Wrappers for using CLAP in other plugin environments
★ 299⑂ 69👁 2⑃ 480● 155▤ 10
+0
Daily
299
stars
69
forks
2
watchers
480
prs
155
issues
10
releases
README
"Wrappers to run your CLAP in other plugin formats instantly."
The clap-wrapper Project
The clap-wrapper project allows you to wrap your CLAP plugin
into other plugin or standalone executable formats, letting your
plugin run in hosts which don't support the CLAP format and
allowing you to distribute standalone executable versions of your
CLAP.
Our wiki is the root of our developer documentation.
Currently the clap-wrapper supports projecting a CLAP into
- VST3
- Audio Unit v2 (AUv2)
- Audio Unit v3 (AUv3, on macOS and iOS)
- AAX
- A Simple Standalone
The clap-wrapper also provides a variety of deployment,
linkage and build time options to CLAP developers.
The Core Idea
The core idea of clap-wrapper is as follows
1. The clap-wrapper is an implementation of a clap host which
will load your CLAP using a variety of techniques.
2. The clap-wrapper provides an implementation of a plugin format
or standalone executable which implements the format to the host
or OS, but uses that host to load your clap.
And with that, voila, your CLAP can appear in a VST3, AUv2 or AUv3
host or can appear to be a self contained standalone executable.
Available features in CLAP are transposed to equivalent features
in the target format.
Getting Started
Our wiki is the root of our developer documentation.
Since building a clap-wrapper involves several choices we
strongly suggest you consult it first.
The simplest form of a clap wrapper, though, is a VST3
which dynamically loads a CLAP of the same name using your
copy of the VST3 and CLAP SDK. To build this, you can use the
simple CMake command
bash
git clone https://github.com/free-audio/clap-wrapper.git
mkdir build
cmake -B build \
-DCLAP_SDK_ROOT={path to clap sdk} \
-DVST3_SDK_ROOT={path to vst3 sdk} \
-DCLAP_WRAPPER_OUTPUT_NAME="The Name of your CLAP"
If you'd like to also build for AUv2 include -DCLAP_WRAPPER_BUILD_AUV2=ON and the SDK in the folder AudioUnitSDK.
To build an AUv3 app extension include -DCLAP_WRAPPER_BUILD_AUV3=ON.
AUv3 builds require the Xcode generator (-G Xcode) — the .appex is
linked as an app-extension product and signed by Xcode; other generators
stop at configure time with an explanatory error. In the clap-first flow,
add AUV3 to PLUGIN_FORMATS instead. See the wiki for the current AUv3
feature status.
On iOS the AUv3 app extension is the only available format, and it
places two requirements on your CLAP:
- it must be linked statically into the appex (iOS app extensions
cannot load a .clap at runtime), so the clap-first layout is required
and one appex hosts exactly one plugin;
- its GUI must support the CLAP_WINDOW_API_UIKIT ("uikit") window API
and attach to the UIView it is given — there is no NSView on iOS.
That constant needs CLAP 1.2.8 or newer.
The appex ships inside a containing app, and for an instrument that app
is a complete standalone synth you can release.
See docs/ios.md for the full iOS instructions.
On WebAssembly nothing is wrapTop issues
#303VST3+Ableton Live does not load parameters properly17 comments · 2024-09-04#414Cannot get raw MIDI output (CLAP_EVENT_MIDI) to work9 comments · 2025-08-10#326VST3+Cubase 14 mono tracks are not working properly9 comments · 2024-12-27#453binary package6 comments · 2026-03-28#84CI runs using LLVM sanitizers6 comments · 2023-09-02#465Where is the vst3 looking for the clap file?5 comments · 2026-05-08#413unable to build standalone on mac due to ibtools (MainMenu.xib)5 comments · 2025-08-03#111MSVC compiler warnings4 comments · 2023-09-08
Discussions
#45830ms timer limit?1 comments · 2026-04-06#398Crash in WrapAsAUV2::CopyClumpName2 comments · 2025-05-27#394Threading model pains6 comments · 2025-05-06#393Host misbehaviours1 comments · 2025-05-06#264How to make fully self contained plugins?3 comments · 2024-06-30#237v0.8.00 comments · 2024-03-14#46Normalising parameter values1 comments · 2023-03-28
Latest release
0.17.0 v0.17.0 2026-10-200.17.0 release Standalone - Native audio and MIDI on all three platforms: CoreAudio/CoreMIDI, WASAPI/WinMM, PipeWire/JACK/ALSA sequencer. RtAudio/RtMidi are still available behind a CMake switch (https://github.com/free-audio/clap-wrapper/pull/601, https://github.com/free-audio/clap-wrapper/pull/599, https://github.com/free-audio/clap-wrapper/pull/597, https://github.com/free-audio/clap-wrapper/pull/596). This switch might be removed in future versions. - New audio/MIDI settings screen: device, sample rate, buffer size, per-note-port MIDI selection and virtual ports. Microphones are opened