• Minimal Clap Host
• Notes on static build vs dynamic build
• Building on macOS
  • dynamic build using brew (recommended)
  • static build using vcpkg
• Building on Windows
  • Enable long path support
  • static build
• Building on Linux
  • dynamic build using system libraries
  • static build using vcpkg

Minimal Clap Host

This repo serves as an example to demonstrate how to create a CLAP host.

Notes on static build vs dynamic build

The host uses Qt for its GUI. It is fine to dynamically link to Qt, but it is not for a plugin. We offer two options:

• static build, cmake preset: ninja-vcpkg or vs-vcpkg on Windows.
• dynamic builg, cmake preset: ninja-system

Static builds are convenient for deployment as they are self containded.

Dynamic builds will get your started quickly if your system provides Qt6. Static builds will require more time and space.

Building on macOS

dynamic build using brew (recommended)

# Install dependencies
brew install qt6 pkgconfig rtaudio rtmidi ninja cmake

# Checkout the code
git clone --recurse-submodules https://github.com/free-audio/clap-host
cd clap-host

# Build
cmake --preset ninja-system
cmake --build --preset ninja-system

static build using vcpkg

# Install build tools
brew install cmake ninja

# Checkout the code
git clone --recurse-submodules https://github.com/free-audio/clap-host
cd clap-host
scripts/build.sh

Building on Windows

Enable long path support

Make sure your system supports long paths. Run this in an administrator PowerShell:

New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force

Reference: https://docs.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=powershell

static build

Install Visual Studio 2022; you can install it from the Microsoft Store. It can also install git and CMake for you.

Use the following command inside git-bash:

# Checkout the code very close to the root to avoid windows long path issues...
cd c:\
git clone --recurse-submodules https://github.com/free-audio/clap-host c-h
cd c-h

scripts/build.sh

Building on Linux

dynamic build using system libraries

# on archlinux, adapt to your distribution and package manager
sudo pacman -S qt git ninja cmake rtaudio rtmidi

git clone --recurse-submodules https://github.com/free-audio/clap-host
cd clap-host
cmake --preset ninja-system
cmake --build --preset ninja-system

static build using vcpkg

git clone --recurse-submodules https://github.com/free-audio/clap-host
cd clap-host
scripts/build.sh