# ZL Equalizer ![pluginval]() [![License](https://img.shields.io/badge/License-AGPLv3-blue.svg)](https://opensource.org/license/agpl-v3) [![Downloads](https://img.shields.io/github/downloads/ZL-Audio/ZLEqualizer/total)](https://somsubhra.github.io/github-release-stats/?username=ZL-Audio&repository=ZLEqualizer&page=1&per_page=30) 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: ```console sudo apt-get update && sudo apt install libasound2-dev libx11-dev libxinerama-dev libxext-dev libfreetype-dev libfontconfig1-dev libwebkit2gtk-4.1-dev libglu1-mesa-dev ``` ### 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`. ```console git clone https://github.com/ZL-Audio/ZLEqualizer cd ZLEqualizer git submodule update --init --recursive cmake -B Builds -G Ninja -DCMAKE_BUILD_TYPE=Release -DKFR_ENABLE_MULTIARCH=ON -DKFR_ARCHS="sse2;avx;avx2" -DZL_JUCE_FORMATS="VST3;LV2" -DZL_EQ_BAND_NUM=24 . cmake --build Builds --config Release ``` 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](LICENSE.md) file. However, the [logo of ZL Audio](assets/zlaudio.svg) and the [logo of ZL Equalizer](assets/logo.svg) are not covered by this license. Copyright (c) 2023 - [zsliu98](https://github.com/zsliu98) JUCE framework from [JUCE](https://github.com/juce-framework/JUCE) JUCE template from [pamplejuce](https://github.com/sudara/pamplejuce) [nlopt](https://github.com/stevengj/nlopt) by [Steven G. Johnson](https://github.com/stevengj) [kfr](https://github.com/kfrlib/kfr) by [KFR](https://github.com/kfrlib) [Material Symbols](https://github.com/google/material-design-icons) by [Google](https://github.com/google) [inter](https://github.com/rsms/inter) by [The Inter Project Authors](https://github.com/rsms/inter) ## 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*](https://blogs.mathworks.com/cleve/2019/04/29/makima-piecewise-cubic-interpolation/). MathWorks Blogs. (2019).

Marketplace

Products by https://github.com/ZL-Audio

ZL Equalizer