ReaPack: Package manager for REAPER

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 https://github.com/cfillion/reapack.git

Prerequisites

Software requirements:

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

Linux

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

• Boost (1.56 or later)
• Catch2
• libcurl
• libxml2
• OpenSSL or compatible
• SQLite
• zlib

macOS

Install Boost and Catch2 using Homebrew (recommended). The build tools can be installed using

xcode-select --install

Windows

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 https://github.com/Microsoft/vcpkg.git C:\path\to\vcpkg
C:\path\to\vcpkg\bootstrap-vcpkg.bat

Set the

VCPKG_ROOT

VCPKG_DEFAULT_TRIPLET

vcpkg install

set VCPKG_ROOT=C:\path\to\vcpkg
set VCPKG_DEFAULT_TRIPLET=%PLATFORM%-windows-static

Install ReaPack's build dependencies:

set /p 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 \
  -DCMAKE_INSTALL_PREFIX=/path/to/reaper/portable/install

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


Cross-compilation

Linux


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

macOS 10.14 or older, Xcode 9 and the latest Clang (
brew install llvm
) are
required for producing 32-bit builds.
cmake -B build \
  -DCMAKE_BUILD_TYPE=Release \
  -DCMAKE_OSX_ARCHITECTURES=i386 \
  -DCMAKE_OSX_DEPLOYMENT_TARGET=10.9 \
  -DCMAKE_TOOLCHAIN_FILE=cmake/brew-llvm.cmake

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.