CChorus

A versatile stereo chorus effect

Formats

This plugin is available in the following plugin formats by default:

• CLAP (de.chrisarndt.cchorus)
• LADSPA (cchorus-ladspa.so)
• LV2 (https://chrisarndt.de/plugins/cchorus)
• VST3 (cchorus.vst3)
• VST2 (cchorus-vst.so)

Some formats are not available on all operating systems, and building of unneeded formats can be disabled when compiling (see "Compiling"):

The plugin depends on the host to provide a generic UI to control parameters.

Compiling

Make sure you have installed the required build tools and libraries (see section "Prerequisites" below) and then clone this repository (including sub-modules) and simply run make in the project's root directory:

$ git clone --recursive https://github.com/SpotlightKid/cchorus.git
$ cd cchorus
$ make

To enable/disable building specific plugin formats, pass options like BUILD_LADSPA=true resp. BUILD_VST2=false to make. For example:

make BUILD_VST2=false

The same settings must be passed to make install to also (not) install these plugin formats.

Installation

To install all plugin formats to their appropriate system-wide location, run the following command (root priviledges may be required):

make install

The makefiles support the usual PREFIX and DESTDIR variables to change the installation prefix and set an installation root directory (defaulty: empty). PREFIX defaults to /usr/local, but on macOS and Windows it is not used, since the system-wide installation directories for plugins are fixed.

Use make's -n option to see where the plugins would be installed without actually installing them.

You can also set the installation directory for each plugin format with a dedicated makefile variable.

• CLAP: CLAP_DIR (<prefix>/lib/clap)
• LADSPA: LADSPA_DIR (<prefix>/lib/ladspa)
• LV2: LV2_DIR (<prefix>/lib/lv2)
• VST2: VST2_DIR (<prefix>/lib/vst)
• VST3: VST3_DIR (<prefix>/lib/vst3)

Example:

make DESTDIR=/tmp/build-root BUILD_VST2=true VST2_DIR=/usr/lib/lxvst install

To install the plugins only for your current user account, run make install-user.

Again, you can also set the installation directory for each plugin format with a dedicated makefile variable.

• CLAP: USER_CLAP_DIR ($HOME/.clap)
• LADSPA: USER_LADSPA_DIR ($HOME/.ladspa)
• LV2: USER_LV2_DIR ($HOME/.lv2)
• VST2: USER_VST2_DIR ($HOME/.vst)
• VST3: USER_VST3_DIR ($HOME/.vst3)

Note: The given default values for all of the above listed makefile variables differ depending on the target OS.

Prerequisites

• The GCC C++ compiler, library and the usual associated software build tools (make, etc.).

  Debian / Ubuntu users should install the build-essential package to get these, Arch users the base-devel meta package.

• patch

• pkgconf

• The faustdoctor post-processor and FAUST (optional)

The CLAP, LV2, LADSPA, VST2 (Xaymar VST2SDK) and VST3 headers are included in the DPF framework, which is integrated as a Git sub-module. These need not be installed separately to build the software in the respective plugin formats.

faustdoctor and FAUST are only needed to re-generate C++ source and header files if the FAUST DSP source files in the faust directory are changed.

Author

This software was created by Christopher Arndt.

License

This plugin is released under the MIT license. Please see the LICENSE.md file for details.

Acknowledgements

The DSP code is generated from the FAUST sources via the faustdoctor post-processor.

The project is built using the DISTRHO Plugin Framework (DPF) and was created from the dpf-faust-project-template using copier.