search

Chowdhury-DSP / BYOD

Build-your-own guitar distortion!
GNU General Public License v3.0
440 stars 24 forks source link

readme

BYOD (Build-Your-Own Distortion)

Download Latest CI License Downloads

BYOD is a guitar effects plugin with a customisable signal chain that allows users to create their own guitar distortion effects. The plugin contains a wide variety of distortion effects from analog modelled circuits to purely digital creations, along with some musical tone-shaping filters, and a handful of other useful signal processors.

Quick Links

Plugin GUI

BYOD is open to contributions! If you would like to add new guitar effect processors, please see the documentation.

Building

To build from scratch, you must have CMake installed.

# Clone the repository
$ git clone https://github.com/Chowdhury-DSP/BYOD.git
$ cd BYOD

# initialize and set up submodules
$ git submodule update --init --recursive

# build with CMake
$ cmake -Bbuild
$ cmake --build build --parallel 4

If you'd like to make an optimized "release" build, it is suggested to use some slightly different build commands:

$ cmake -Bbuild -DCMAKE_BUILD_TYPE=Release
$ cmake --build build --config Release --parallel 4

BYOD requires CMake version 3.15 or higher, however, BYOD CLAP builds require CMake 3.21 or higher. CLAP builds can be disabled by adding -DBYOD_BUILD_CLAP=OFF to the first CMake command.

After a successful build, the resulting plugin binaries will be located in build/BYOD_artefacts.

If building for Linux, please review the Linux dependencies used by the BYOD CI pipeline.

Compiling with OpenGL support

By default, OpenGL support is enabled on Windows, and is disabled on all other platforms. If you would like to override the default behaviour, you can pass the argument -DCHOWDSP_ENABLE_OPENGL=<ON|OFF> to the CMake configure step.

Credits:

Credits for the individual processors are shown on the information page for each processor. Big thanks to all who have contributed!

License

BYOD is open source, and is dual-licensed under the General Public License Version 3. For more details, please see the licensing documentation. Enjoy!