/ddsp-vst

Realtime DDSP Neural Synthesizer and Effect

Primary LanguageC++Apache License 2.0Apache-2.0

logo

DDSP-VST

Build Format

VST3/AU plugins and desktop applications built using the JUCE framework and DDSP.

DDSP Effect DDSP Synth

Helpful Links

Installation

macOS

  1. Download the plugin binaries from here.
  2. Unzip and copy the two plugins (DDSP Effect and DDSP Synth) to their respective system folders:
    • Audio Unit: /Library/Audio/Plug-Ins/Components
    • VST3: /Library/Audio/Plug-Ins/VST3
  3. Rescan for new plugins in your respective DAW (verified on Ableton/Logic Pro/FL Studio/Reaper).

Windows

  1. Download the plugin binaries from here.
  2. Unzip and copy the two VST3 plugins (DDSP Effect and DDSP Synth) to C:\Program Files\Common Files\VST3
  3. Rescan for new plugins in your respective DAW (verified on Ableton//Reaper).

Usage

Take a look at this guide on how to use the plugins!

Build

Supported Platforms

  • macOS
  • Windows

Setup

Prerequisites

  • CMake 3.15 or above
  • macOS
    • Xcode
    • Ninja (optional)
  • Windows
    • Visual Studio 2022
    • Git Bash

Initialize

Clone this repo and run the following script to initialize the submodules and download DDSP models.

./repo-init.sh

macOS

  • Generate Xcode project files (recommended for development and debugging):
    • cmake -B build -S . -G Xcode
    • Open DDSP.xcodeproj, select a target and build.
  • For release, we recommend building with Ninja or CMake since building XNNPACK is unsupported on Xcode. Additionally, Ninja builds are faster compared to CMake.
    • cmake -B build-ninja -S . -G Ninja
    • Build all targets: cmake --build build-ninja
  • Plugins will be copied to ~/Library/Audio/Plug-Ins directory automatically post-build.

Windows

  • Generate Visual Studio 2022 solution:
    • cmake -B build -G "Visual Studio 17 2022"
  • CMake adds m.lib as a dependency which causes a build error, this can be removed by running the following script after generating build files.
    • ./scripts/remove-m-lib-win.sh
  • You may encounter errors when building TFLite, they can be fixed by applying this patch.
  • Build the VST3 targets and copy plugin binaries to C:\Program Files\Common Files\VST3
  • If the plugin UI looks blurred on Ableton, right click on the plug-in title bar and deselect "Auto-Scale Plugin Window". More information can be found here

CMake

  • Edit cmake/FileList.cmake to add new source files to the project.
  • Compiler/linker options and project version can be found in cmake/Config.cmake.

Contributing

We're eager to collaborate with you! Take a look at the contribution guidelines on how to contribute.

Disclaimer

This is not an official Google product.