A collection of VST3 audio plugins, and an extention to REAPER for production of next generation audio content using the EBU ADM Renderer.
You can download prebuilt versions of the plugins and extension using the link below. There is also an experimental Linux build available, but be aware this is only experimental and could prove buggy.
Releases: https://ear-production-suite.ebu.io/
There are two methods of installation; using the setup application, or manual.
For Windows and MacOS, the download package will contain a Setup application.
For MacOS, mount the downloaded disk image and run the "Setup EAR Production Suite" application within.
For Windows, extract the contents of the downloaded package to a temporary location and run the setup application.
After download, copy the ear-production-suite
folder and the ADM Export Source
plugin to the correct folder as shown in the following table.
System | Folder |
---|---|
macOS | ~/Library/Audio/Plug-ins/VST3 |
Windows | C:\Program Files\Common Files\VST3 |
Linux | ~/.vst3 |
To install the extension, you must copy the dynamic library reaper_adm
from the UserPlugins
directory of the downloaded package to your REAPER resource path.
You can open this resource folder from within REAPER via
[Options] -> [Show REAPER resource path in explorer/finder...]
The recommended way to build the plugins is via CMake's preset mechanism. Before you can make use of that you'll need a few tools.
- Compiler with C++14 support
- CMake build system (version 3.21.0 or higher for
--preset
support, 3.8 or higher for manual build) - Ninja
The easiest way to set up a suitable environment is to follow the homebrew setup instructions. Once you have a working homebrew:
brew update
brew install cmake ninja
The following instructions are for an x64 (Intel processor) build. For ARM64 (Apple Silicon), use the macos-default-arm64
preset in place of macos-default
.
git clone --recursive https://github.com/ebu/ear-production-suite.git
cd ear-production-suite
./submodules/vcpkg/bootstrap-vcpkg.sh # ensures vcpkg is setup
cmake --preset macos-default # configures project, downloads & builds dependencies
cmake --build --preset macos-default # builds project
cmake --build --preset macos-default --target install
The location of the installed VST3 plugins will be
~/Library/Audio/Plug-Ins/VST3/
The location of the installed REAPER extension will be
~/Library/Application Support/REAPER/UserPlugins/
Microsoft Visual Studio 2019, installed with C++ support provides a suitable compiler.
You'll need to install CMake and Ninja manually, add their installation locations to your PATH. Then, execute the following steps from a Visual Studio x64 developer command prompt.
git clone --recursive https://github.com/ebu/ear-production-suite.git
cd ear-production-suite
.\submodules\vcpkg\bootstrap-vcpkg.bat # ensures vcpkg is setup
cmake --preset windows-default # configures project, downloads & builds dependencies
cmake --build --preset windows-default # builds project
From an administrator command prompt, run
cmake --build --preset windows-default --target install
The VST3 plugins will be installed to your Windows Program Files directory. The location of the installed VST3 plugins will be
<Program Files>\Common Files\VST3\
The REAPER extension will be installed to the AppData directory for the current user (as specified by the AppData
environment variable, which will normally resolve to the Roaming
subdirectory.)
The location of the installed REAPER extension will be
~\AppData\Roaming\REAPER\UserPlugins\
These instructions are for Ubuntu 20.04, but other distributions should be similar.
Presets are currently only defined for x86_64; other architectures are untested but can probably be built manually or with a modified CMakePresets.json file.
To get an up-to-date version of cmake, follow the instructions on the Kitware APT repository.
For the rest of the dependencies, run:
# tools for vcpkg
sudo apt-get install build-essential curl zip unzip tar git cmake ninja-build pkg-config
# graphics libraries
sudo apt-get install libx11-dev libxcursor-dev libxext-dev libxinerama-dev libxrandr-dev libglu1-mesa-dev libfreetype6-dev
git clone --recursive https://github.com/ebu/ear-production-suite.git
cd ear-production-suite
./submodules/vcpkg/bootstrap-vcpkg.sh # ensures vcpkg is set up
cmake --preset linux-default-x64 # configures project, downloads & builds dependencies
cmake --build --preset linux-default-x64 # builds project
cmake --build --preset linux-default-x64 --target install
The location of the installed VST3 plugins will be
~/.vst3
The location of the installed REAPER extension will be
~/.config/REAPER/UserPlugins/
If the defaults do not suit you, they can be customised with two CMake variables
EPS_PLUGIN_INSTALL_PREFIX # This specifies the directory to which the plugins should be installed
EPS_EXTENSION_INSTALL_PREFIX # This specifies the directory containing the REAPER plugins subdirectory
# to which the extension should be installed
If manually set, both of these variables must end with a trailing /
.
They should be provided at configure stage using CMake's -D
flag (set cache variable). For example:
cmake --preset macos-default -DEPS_PLUGIN_INSTALL_PREFIX="/a/hidden/place/" -DEPS_EXTENSION_INSTALL_PREFIX="/top/secret/location/"