This repository contains JUCE modules with utilities for building Chowdhury DSP plugins.
There are a handful of simple examples in the examples/
directory.
For complete documentation, see the API docs.
If you are using JUCE with CMake, simply add this repository as a subdirectory after adding JUCE to your CMake project.
add_subdirectory(JUCE)
add_subdirectory(chowdsp_utils)
target_link_libraries(MyTarget PUBLIC
juce::juce_audio_utils
juce::juce_dsp
# other JUCE modules...
chowdsp::chowdsp_dsp_utils
chowdsp::chowdsp_gui
chowdsp::chowdsp_plugin_base
# Other modules and libraries...
)
Alternatively, you may add these modules from the repository directory using the Projucer.
If you are using a non-JUCE CMake project, it is possible to create your own static library from the DSP modules in this repository:
add_subdirectory(chowdsp_utils)
# create static library based on these modules
setup_chowdsp_lib(chowdsp_lib # Name of the static library
MODULES chowdsp_math chowdsp_dsp_utils # DSP modules that should be included in the library...
)
# link the static library to your project
target_link_libraries(MyCoolProject PRIVATE chowdsp_lib)
If you would like to build the example plugins included in this repository, you may clone the repository, and use the following CMake commands:
cmake -Bbuild -DCHOWDSP_ENABLE_EXAMPLES=ON
cmake --build build --target $EXAMPLE_TARGET
where $EXAMPLE_TARGET
is the name of the target you'd like to build,
for example SimpleEQ_Standalone
.
The modules in this repository are mostly dependent on C++17 or later. Modules not in the "Common" or "DSP" categories also depend on JUCE 6 or later.
There are a few other dependencies as well, some of which are bundled internally within the repository, and others which must be managed externally. In either case, you must be sure to abide by the license of each module, as well as whichever libraries are being used.
chowdsp_core
(BSD)
DoubleBuffer
: A circular buffer which always maintains a contiguous block of data.TupleHelpers
: Useful methods for working with tuple-like data structures.AtomicHelpers
: Useful methods for working with atomics.MemoryUtils
: Helpful methods to check if blocks of memory alias with each other.TypeTraits
: Type traits for checking if a class has a given method, if a type is a container, and so on.
chowdsp_json
(BSD)
- A thin wrapper around
nlohmann::json
(MIT license, included internally).
chowdsp_listeners
(BSD)
- A thin wrapper around
rocket
(Public Domain, included internally).
chowdsp_reflection
(BSD)
- A thin wrapper around
boost::pfr
(Boost license, included internally). - A thin wrapper around
nameof
(MIT license, included internally). - A thin wrapper around
magic_enum
(MIT license, included internally).
chowdsp_serialization
(BSD)
- Tools for serializing/deserializing data, using JSON or XML formats.
chowdsp_dsp_data_structures
(GPLv3)
Buffer
/BufferView
: Basic data structures for storing audio.LookupTableTransform
: Some modifications onjuce::dsp::LookupTableTransform
.LookupTableCache
: A cache for storing lookup tables, so they don't need to be re-computed.ScopedValue
: A stack value that writes its value back to a more permanent variable when it goes out of scope.SmoothedBufferValue
: A buffered version ofjuce::SmoothedValue
.COLAProcessor
: A base class for doing Constant Overlap-Add processing.RebufferedProcessor
: A processor which rebuffers the input to have a constant block size.- Wrappers around
moodycamel
's lock-free queues (modified BSD)
chowdsp_dsp_utils
(GPLv3)
- Utilities for working with convolution and impulse responses.
DelayLine
: A re-implementation ofjuce::dsp::DelayLine
with more interpolation options.PitchShifter
: Simple pitch-shifting effect using a ring buffer with two read pointers.- Useful classes for modal signal processing.
- Various classes for integer or non-integer resampling
- Optionally depends on libsamplerate. User must link with libsamplerate externally, and define
CHOWDSP_USE_LIBSAMPLERATE=1
- Optionally depends on libsamplerate. User must link with libsamplerate externally, and define
- A few other useful processors.
chowdsp_eq
(GPLv3)
EQBand
: A single EQ band.EQProcessor
: A collection of EQ bands.LinearPhaseEQ
: Constructs a linear phase EQ from a given prototype EQ.
chowdsp_filters
(GPLv3)
- Basic first and second order filters (HPF/LPF/BPF, shelving filters, peaking filters, notch filters).
- Higher-order filters (Butterworth, Chebyshev (Type II), Elliptic).
StateVariableFilter
: A modified version ofjuce::dsp::StateVariableTPTFilter
with more filter types and better performance.ModFilterWrapper
: Turns any biquad filter into a State Variable Filter.FIRFilter
: An FIR filter with SIMD optimizations.WernerFilter
: Emulation of a generalized Octave-CAT-style SVF, as proposed by Kurt Werner.ARPFilter
: Emulation of the ARP 1047 multi-mode filter.FractionalOrderFilter
: A filter with a slope between 0-3 dB / octave.ConformalMaps
: Conformal maps to use for designing filters, including the bilinear and alpha transforms.FilterChain
: Utility template class for chaining multiple similar filters in series.
chowdsp_math
(BSD)
- Internally includes gcem (Apache 2.0)
FloatVectorOperations
: Some extensions onjuce::FloatVectorOperations
.BufferMath
: Math operations which can be applied to audio buffers.Polynomials
: Methods for evaluating polynomials with Horner's method or Estrin's scheme.Power
: Fast integer exponential operations.- A few other useful math operations.
chowdsp_reverb
(GPLv3)
- Some modular template classes for constructing Feedback Delay Network reverbs.
chowdsp_simd
(BSD)
- A wrapper around XSIMD (BSD, included internally).
SIMDSmoothedValue
: A SIMD specialization ofjuce::SmoothedValue
.- A few other extra SIMD math functions.
chowdsp_sources
(GPLv3)
SineWave
: a "magic circle" sine wave oscillator.- Other basic oscillators implemented with aliasing suppression:
SawtoothWave
SquareWave
TriangleWave
Noise
: a noise generator with options for Guassian (normal), uniform, and pink noise.
chowdsp_waveshapers
(GPLv3)
- Basic waveshaping processes implemented with integrated waveshaping (ADAA), including:
ADAAHardClipper
ADAATanhClipper
ADAASoftClipper
: A polynomial soft clipperADAAFullWaveRectifier
WestCoastFolder
: An emulation of the wavefolding circuit found from the Buchla 259WaveMultiplier
: An emulation of Serge Tcherepin's Wave Multiplier circuit
chowdsp_gui
(GPLv3)
- Custom
LookAndFeel
. - Helper class for optionally using OpenGL.
- Helper classes for working with long-presses and popup menus on touch screens.
- Custom tooltip viewer.
- Component to display plugin info (version, format, etc.).
- Component for controlling preset management.
chowdsp_foleys
(GPLv3)
- Interface between
chowdsp_gui
andfoleys_gui_magic
(must be linked externally).
chowdsp_rhythm
(BSD)
- Utilities for working with rhythms, and converting between a rhythm and a unit of time.
chowdsp_clap_extensions
(BSD)
- Helper classes for implementing features specific to the CLAP plugin format.
CLAPExtensions::CLAPInfoExtensions
: implementsgetPluginTypeString()
.ModParameterMixin
: interface for supporting CLAP parameter modulation.
chowdsp_parameters
(BSD)
ParamUtils
: Useful methods for creating parameters.ForwardingParameter
: A parameter that forwards on a parameter from another processor.
chowdsp_plugin_state
(BSD)
PluginState
: Replacement forjuce::AudioProcessorValueTreeState
.- Parameter "attachments" for connecting the plugin state to various UI elements.
chowdsp_plugin_base
(GPLv3)
- Base classes for creating audio effect or synthesizer plugins.
chowdsp_plugin_utils
(GPLv3)
FileListener
: A listener which triggers a callback whenever a file is changed.PluginLogger
: A logging system which can be used within a plugin.SharedPluginSettings
: A shared object for managing settings which apply to all instances of a plugin.SharedLNFAllocator
: A shared object for managingjuce::LookAndFeel
classes.AudioUIBackgroundThread
: A thread class which accepts data from the audio thread, and performs a background task (often useful for creating meters).DeferredAction
: A helper class for queueing an action to be run on the main thread (real-time safe).
chowdsp_presets
(BSD)
- A system for managing plugin presets.
chowdsp_version
(BSD)
- Utilities for managing the version of an app or plugin.
The development environment for this repository expects the following directory structure:
|- JUCE
|- modules
|- foleys_gui_magic
|- chowdsp_utils
To build the module tests, run:
cmake -Bbuild -DCHOWDSP_ENABLE_TESTING=ON
cmake --build build --target $TEST_TARGET
where $TEST_TARGET
is the name of the test target you'd like to build.
If you would like to build the tests with flags for analyzing code coverage,
add -DCODE_COVERAGE=ON
to the CMake configure step.
Toe build the module benchmarks, run:
cmake -Bbuild -DCMAKE_BUILD_TYPE=Release -DCHOWDSP_ENABLE_BENCHMARKS=ON
cmake --build build --config Release $BENCH_TARGET
where $BENCH_TARGET
is the name of the benchmark you would like to build.
Each module in this repository has its own unique license. If you would like to use code from one of the modules, please check the license of that particular module.
If you are making a proprietary or closed source app and would like to use code from a module that is under a GPL-style license, please contact chowdsp@gmail.com for non-GPL licensing options.
All non-module code in this repository (tests, examples, benchmarks, etc.) is licensed under the GPLv3.