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: git@github.com: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 contact@auburnsounds.com

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)