ZL Equalizer

ZL Equalizer is an equalizer plugin.

Build from Source

Install Dependencies

Please make sure Clang (AppleClang 16+ or LLVM/Clang 17+), cmake (minimum 3.25), ninja are installed and configured on your OS.

On Windows (with Intel chips), you may install Intel® Integrated Performance Primitives and set its path as an environment variable IPP_DIR. It is not a hard requirement as KFR has already been used for SIMD/DFT acceleration.

On Linux, you can install the remaining dependencies with the following command:

Clone and Build

Once you have set up the environment, you can clone the ZL Equalizer code, populate all submodules, then configure & build the code. Please set:

• the variable ZL_JUCE_FORMATS as a list of formats that you want, e.g., "VST3;LV2".
  • AAX plug-ins need to be digitally signed using PACE Anti-Piracy's signing tools before they will run in commercially available versions of Pro Tools.
• the variable ZL_EQ_BAND_NUM as the number of bands, default 24 bands
  • The plugins built with different ZL_EQ_BAND_NUM may NOT be compatible with each other.
• the variable KFR_ARCHS as a list of SIMD instruction sets you want to dispatch
  • If you are on x86_64, set it as "sse2;avx;avx2".
  • If you are on arm64, set it as "neon64".
  • If you know the SIMD instruction sets (fully) supported by your CPU, set it as the one with the largest register size. For example, if your CPU supports SSE2 & SSE41 & AVX, set it as "avx".
  • I would suggest excluding avx512 even if it is supported by your CPU.
• If there are multiple compilers on your OS, you may need to pass extra flags to maker sure that cmake uses LLVM/Clang.
  • On Linux, you may pass -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++.
  • On Windows, you may pass -DCMAKE_C_COMPILER=clang-cl -DCMAKE_CXX_COMPILER=clang-cl.

After building, the plugins should have been copied to the corresponding folders. If you want to disable the copy process, you can pass -DZL_JUCE_COPY_PLUGIN=FALSE, find the binary folders under Builds/ZLEqualizer_artefacts/Release and copy them manually.

License

ZL Equalizer is licensed under AGPLv3, as found in the LICENSE.md file. However, the logo of ZL Audio and the logo of ZL Equalizer are not covered by this license.

Copyright (c) 2023 - zsliu98

JUCE framework from JUCE

JUCE template from pamplejuce

nlopt by Steven G. Johnson

kfr by KFR

Material Symbols by Google

inter by The Inter Project Authors

References

Vicanek, Martin. Matched One-Pole Digital Shelving Filters. (2019).

Vicanek, Martin. Matched Second Order Digital Filters. (2016).

Redmon, Nigel. Cascading filters. (2016).

Wishnick, Aaron. Time-Varying Filters for Musical Applications. DAFx. (2014).

Moler, Cleve. Makima Piecewise Cubic Interpolation. MathWorks Blogs. (2019).