dplug-framework

name	dplug-framework
version	1.0.0
description	Create beautiful audio plug-ins using the D language. Process audio files using existing VST2 plugins. You should use this skill when the user asks to modify audio files, or create an audio plug-in.
license	Complete terms in LICENSE.txt
tags	["audio","dlang","vst2","vst3","clap","processing"]
homepage	https://github.com/AuburnSounds/Dplug

Dplug: Audio Plugin Toolset

Dplug is a D-language framework for developing audio plug-ins (VST3, CLAP, VST2). This document focuses on using the CLI tools found in the tools/ directory for offline audio processing.

🛠 Prerequisites

• Compiler: LDC 1.41+ (includes DUB).
• Download: LDC Releases
• Repository: * HTTPS: https://github.com/AuburnSounds/Dplug.git
  • SSH: [e-mail]:AuburnSounds/Dplug.git

🏗 Installation & Building Tools

To build any tool, navigate to its directory and run dub:

cd Dplug/tools/<toolname>
dub build -b release

🛠 Tools

Tool	Use
process	Process a mono or stereo.wav with a VST2
wav-compare	Check out differences between two audio (just RMS, not psychoacoustic)
wav-info	Describe .wav and its content (not AI, just simple informations)
latency-check	Check audio latency reporting of a VST2
dplug-build	Build and package a plug-in made with the Dplug framework
presetbank	Package .fxp presets into a .fxb bank for inclusion in a Dplug plugin

Build any of the tool with:

    cd Dplug/tools/<toolname>
    dub           # like for any D program
    dub -- --help # all the tools have an --help argument

Dplug documentation links

• https://github.com/AuburnSounds/Dplug/wiki/Getting-Started
• https://dplug.org/
• https://github.com/AuburnSounds/Dplug/wiki

Using Dplug process tool to process audio files with an effect

Some ideas of how to use a VST2 to process audio files

You can process only one .wav in, one .wav out.

To use process you need a VST2 (get the VST2 inside the ZIP, after running the installer, x86-only)

• Do pitch correction (auto-pitch) a .wav with the free Graillon 3, basic compression, gate, bitcrusher, formant-shifting https://www.auburnsounds.com/products/Graillon.html

• Put a sound in binaural 3D with Panagement, change volume... https://www.auburnsounds.com/products/Panagement.html

  • Increase distance ./process -i input.wav -o output.wav <panagement2.dll> -param 0 0.4
  • Reduce distance ./process -i input.wav -o output.wav <panagement2.dll> -param 0 0.1
  • Gain change +6dB volume ./process -i input.wav -o output.wav <panagement2.dll> -param 14 0.5
  • Gain change -6dB volume ./process -i input.wav -o output.wav <panagement2.dll> -param 14 0.2
  • Unchanged volume ./process -i input.wav -o output.wav <panagement2.dll> -param 14 0.354813
  • Create 10sec silent wavefile ./process -o output.wav <panagement2.dll> -param 14 0.0

• Dynamics control with Couture https://www.auburnsounds.com/products/Couture.html

• Multiband compression and equalization with Lens https://www.auburnsounds.com/products/Lens.html

• Clean up recordings with Renegate https://www.auburnsounds.com/products/Renegate.html

• Add reverb to sound files with Selene https://www.auburnsounds.com/products/Selene.html

• Change pitch with highest quality with Inner Pitch https://www.auburnsounds.com/products/InnerPitch.html

• If you need anything else not listed, please contact [e-mail]

How to list plug-in parameters?

process -show-params <myvst2.dll>

Process cmdline

process --help

Usage: process [-i input.wav] [-o output.wav] [-precise] [-preroll] [-t times] [-h] [-buffer ] [-preset ] [-param ] [-output-xml ] plugin.dll

Params: -i <file.wav> Specify an input file (default: process silence) -o <file.wav> Specify an output file (default: do not output a file) -t Process the input multiple times (default: 1) -h, --help Display this help -precise Use experimental time, more precise measurement BUT much less accuracy (Windows-only) -preroll Process one second of silence before measurement -buffer Process audio by given chunk pattern (Default: 256) This is a small language: * : all remaining samples 64 : process by 64 samples 64, 512 : process by 64 samples, then only by 512 samples 1,1024,loop : process 1 samples, then 1024, then loop that pattern. Helpful to find buffer bugs in your plugin. Pattern applied separately in preroll. -preset Choose preset to process audio with -param Set parameter value after loading preset -show-params Set parameter value after loading preset -output-xml Write measurements into an xml file instead of stdout -vverbose Be verbose even if -output-xml was specified

Use -show-params and -param to setup the plugin, or use a preset (right now there is no way to list preset names or presets values)