A collection of spatial audio related VST/LV2 plug-ins developed using JUCE and the Spatial_Audio_Framework
Spatial Audio Real-Time Applications (SPARTA) [1]. A collection of VST/LV2 audio plug-ins for spatial audio production, reproduction and visualisation. Developed using JUCE and the Spatial_Audio_Framework.
This repository contains the following audio plug-ins:
The plug-in suite may be downloaded from here [Mac OSX (10.10 or higher), Linux (x86_64), and Windows (x86_64)].
First clone the repository (including submodules) with:
git clone --recursive https://github.com/leomccormack/SPARTA
# or if you have already cloned the repository, update/init with:
git submodule update --init --recursive
The VST2_SDK should be placed in the 'SDKs' folder like so:
SDKs/VST2_SDK
By default, MacOSX, Linux and Windows (x86_64/amd64) users need to install Intel oneAPI (MKL and IPP) and run the install-safmkl.sh/.bat and install-safipp.sh/.bat scripts found in SDKs/Spatial_Audio_Framework/scripts. Whereas, Raspberry Pi (ARM) users instead require OpenBLAS and LAPACKE libraries:
sudo apt-get install liblapack3 liblapack-dev libopenblas-base libopenblas-dev liblapacke-dev
Note, however, that alternative performance libraries may also be used, with more information provided here.
Linux (x86_64/amd64 and ARM) users must also install the following libraries required by JUCE:
sudo apt-get install x11proto-xinerama-dev libwebkit2gtk-4.0-dev libgtk-3-dev x11proto-xext-dev libcurl4-openssl-dev libasound2-dev
The plug-ins may be built with CMake (version 3.15 or higher):
mkdir build
cmake -S . -B build -DSAF_ENABLE_SOFA_READER_MODULE=1
cd build
make
Or for Visual Studio 2022 users (using x64 Native Tools Command Prompt as administrator; and also e.g., building LV2 and VST3 versions):
cmake -S . -B build -G "Visual Studio 17" -DSAF_ENABLE_SOFA_READER_MODULE=1 -DBUILD_PLUGIN_FORMAT_LV2=1 -DBUILD_PLUGIN_FORMAT_VST3=1
cd build
msbuild ALL_BUILD.vcxproj /p:Configuration=Release /m
MacOSX/Linux users may run the following bash script via the Terminal to build all of the plugins:
./build-plugins.sh all
# Note: MacOSX users may need to first install and enable Xcode Command Line Tools:
xcode-select --install
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
Windows users may instead run the following batch script via the "x64 Developer Command Prompt for VS.exe":
build-plugins.bat <path/to/Projucer.exe>
The repository also includes the following install scripts:
./install-juce.sh # builds a GPLv3 version of the Projucer App and copies it into "SDKs"
./install-vst2_sdk.sh # downloads, unzips, and places the VST2_SDK into "SDKs"
The build.plugins.sh script also supports many additional options:
./build-plugins.sh --help # help information
./build-plugins.sh projuce # generates Linux makefiles and IDE project files for all plugins
./build-plugins.sh clean # cleans all plugins
./build-plugins.sh build # builds all plugins
./build-plugins.sh all # projuces, cleans, and then builds all plugins
./build-plugins.sh _SPARTA_ambiBIN_ all # projuces+cleans+builds sparta_ambiBIN.vst
./build-plugins.sh _SPARTA_ambiENC_ build # builds "sparta_ambiENC.vst"
./build-plugins.sh _SPARTA_array2sh_ projucer # opens "sparta_array2sh.jucer" with Projucer
You may also manually open each .jucer file with the Projucer App and click "Save Project". This will generate Visual Studio (2017) solution files, Xcode project files, Linux Makefiles (amd64), and Raspberry Pi Linux Makefiles (ARM), which are placed in:
audio_plugins/_SPARTA_X_/make/
To generate project files for other IDEs, you may open and configure the included .jucer files accordingly.
Suggestions and contributions to the code are both welcomed and encouraged. Feel free to branch off and submit pull requests. If the changes/additions are major, then consider first discussing it via a github "issue" thread.
This project is provided under the GPLv3 License - see the LICENSE file for details.