Skip to content

studiorack/studiorack-template-dpf

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

studiorack-template-dpf

Release

Audio plugin starter template using DPF framework to build binaries using:

  • Bash
  • CMake 3.15.x
  • DPF

Installation

Install CMake and Xcode using:

brew install cmake
xcode-select --install

Check you have the correct dependencies installed:

cmake -version
xcodebuild -version

Ensure all git submodules are initialized:

git submodule update --init --recursive

Usage

Make all your plugin development changes in the source folder at:

./src

Ensure you also update the preview image and audio files:

./src/assets/name.png
./src/assets/name.wav

Testing your plugin

Todo

Build (manual)

Depending on the the operating system you are on/building for, swap the generator string in the build commands:

  • Linux: "Unix Makefiles"
  • MacOS: "Xcode"
  • Windows: "Visual Studio 16 2019"

Compile a development version of the plugin using:

cmake \
  -G "Xcode" \
  -DCMAKE_BUILD_TYPE=Debug \
  -S ./sdk \
  -B ./build
cmake --build ./build --config Debug

View the built plugin files at:

./build/bin

Build the final plugin binaries using:

cmake \
  -G "Xcode" \
  -DCMAKE_BUILD_TYPE=Release \
  -S ./sdk \
  -B ./build
cmake --build ./build --config Release

Copy any additional metadata files:

cp -v ./src/assets/* ./build/bin

For metadata generation as json use the studiorack-cli:

npm install @studiorack/cli -g

Validate your plugin:

studiorack validate "./build/bin/**/*.{vst,vst3}"

Convert and enrich validator report metadata into json:

studiorack validate "./build/bin/**/*.{vst,vst3}" --json

Build (automatic)

Release a plugin version on GitHub by simply creating a version tag:

git tag v0.0.1
git push && git push origin --tags

This will run an automated build and release process on GitHub Actions:

.github/workflows/release.yml

Resources & guides

Contact

For more information please contact kmturley

About

Audio plugin starter template using DPF framework to build audio plugins

Resources

License

Stars

Watchers

Forks

Packages

No packages published