Skip to content
📦 Package manager for REAPER
C++ CMake Other
Branch: master
Clone or download

ReaPack: Package manager for REAPER

Build status macOS build status Donate

Visit the ReaPack website for ready-to-use binaries, the user guide or the package upload tool.

Building from source

Clone the repository and submodules:

git clone --recursive


Software requirements:

  • CMake 3.15 or newer
  • C++17 compiler (MSVC on Windows)
  • PHP (Linux and macOS only)


Install the following libraries (and development headers if your system provides them separately):


Install Boost and Catch2 using Homebrew (recommended). The build tools can be installed using xcode-select --install or the Xcode IDE.


MSVC can be installed with the Build Tools for Visual Studio or the Visual Studio IDE.

Use the x64 or x86 Native Tools Command Prompt for VS 20XX matching the target architecture when configuring or building ReaPack.

Install vcpkg in any directory:

git clone C:\path\to\vcpkg

Set the VCPKG_ROOT and VCPKG_DEFAULT_TRIPLET environment variables (only required when running vcpkg install or creating a new build tree):

set VCPKG_ROOT=C:\path\to\vcpkg

Install ReaPack's build dependencies:

set /p reapack-deps=<vendor\vcpkg-deps.txt
%VCPKG_ROOT%\vcpkg install %reapack-deps%

Build configuration

Create and configure a new build tree inside of the build directory.

cmake -B build -DCMAKE_BUILD_TYPE=Debug

Using the Ninja generator is recommended for best performances:

cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Debug

Alternatively, multiple build trees can be created if desired:

cmake -B build/debug    -DCMAKE_BUILD_TYPE=Debug
cmake -B build/release  -DCMAKE_BUILD_TYPE=Release
cmake -B build/portable -DCMAKE_BUILD_TYPE=RelWithDebInfo \

The vcpkg install is automatically detected and configured from the VCPKG_ROOT and VCPKG_DEFAULT_TRIPLET environment variables when creating a build tree on Windows.

Compile and install

To compile a build tree:

cmake --build build

To install ReaPack into your REAPER installation after building:

cmake --build build --target install

The following targets are available:

  • all: Build ReaPack (default target)
  • clean: Delete all generated files (can be run before building another target using --clean-first)
  • install: Build and install ReaPack into REAPER's resource directory (as specified in CMAKE_INSTALL_PREFIX)
  • test: Build and run the test suite



g++-$TOOLCHAIN_PREFIX will be used when compiling for architectures other than i686. Libraries for the target architecture are expected to be in /usr/{include,lib}/$TOOLCHAIN_PREFIX, /usr/$TOOLCHAIN_PREFIX/{include,lib} or /usr/lib32.

ARCH=i686 TOOLCHAIN_PREFIX=i386-linux-gnu \
  cmake -B build/i686 -DCMAKE_TOOLCHAIN_FILE=cmake/linux-cross.cmake

ARCH=armv7l TOOLCHAIN_PREFIX=arm-linux-gnueabihf \
  cmake -B build/arm32 -DCMAKE_TOOLCHAIN_FILE=cmake/linux-cross.cmake

ARCH=aarch64 TOOLCHAIN_PREFIX=aarch64-linux-gnu \
  cmake -B build/arm64 -DCMAKE_TOOLCHAIN_FILE=cmake/linux-cross.cmake


macOS 10.14 or older, Xcode 9 and the latest Clang (brew install llvm) are required for producing 32-bit builds.

cmake -B build \

Support and feedback

Ask any ReaPack-releated questions in the ReaPack forum thread. Questions related to development or packaging can be asked in the development thread.

Report bugs or request features in the issue tracker. Send code contributions as pull requests.

You can’t perform that action at this time.