https://github.com/zl-audio/zlsplitter
splitter plugin
https://github.com/zl-audio/zlsplitter
audio-effect audio-unit crossover juce lv2 transient vst3
Last synced: 4 months ago
JSON representation
splitter plugin
- Host: GitHub
- URL: https://github.com/zl-audio/zlsplitter
- Owner: ZL-Audio
- License: agpl-3.0
- Created: 2024-05-11T17:40:01.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-12-14T02:37:27.000Z (6 months ago)
- Last Synced: 2025-12-15T06:49:58.174Z (6 months ago)
- Topics: audio-effect, audio-unit, crossover, juce, lv2, transient, vst3
- Language: C++
- Homepage: https://zl-audio.github.io/plugins/zlsplitter/
- Size: 848 KB
- Stars: 111
- Watchers: 1
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# ZL Splitter
![pluginval]()
[](https://opensource.org/license/agpl-v3)
[](https://somsubhra.github.io/github-release-stats/?username=ZL-Audio&repository=ZLSplitter&page=1&per_page=30)
ZL Splitter is a splitter plugin.
A short intro video is available at [here](https://www.youtube.com/watch?v=-RVm9mbbQtA).
## Usage
See the [manual](https://zl-audio.github.io/plugins/zlsplitter/) for details.
## Download
See the releases for the latest version.
**Please NOTICE**:
- the installer has **NOT** been notarized/EV certificated on macOS/Windows
- the plugin has **NOT** been fully tested on DAWs
## Build from Source
### Install Dependencies
Please make sure `Clang` (`AppleClang 16+` or `LLVM/Clang 17+`), `cmake 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 Splitter 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"`.
```console
git clone https://github.com/ZL-Audio/ZLSplitter
cd ZLSplitter
git submodule update --init --recursive
cmake -B Builds -G Ninja -DCMAKE_BUILD_TYPE=Release -DKFR_ENABLE_MULTIARCH=OFF -DZL_JUCE_FORMATS="VST3;LV2" .
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/ZLCompressor_artefacts/Release` and copy them manually.
> 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`.
> 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.
## License
ZL Splitter 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 Splitter](assets/logo.svg) are not covered by this license.
Copyright (c) 2024 - [zsliu98](https://github.com/zsliu98)
JUCE framework from [JUCE](https://github.com/juce-framework/JUCE)
JUCE template from [pamplejuce](https://github.com/sudara/pamplejuce)
[kfr](https://github.com/kfrlib/kfr) by [KFR](https://github.com/kfrlib)
[median-filter](https://github.com/suomela/median-filter) by [suomela](https://github.com/suomela)
[Material Symbols](https://github.com/google/material-design-icons) by [Google](https://github.com/google)
Font from CMU Open Sans, Font Awesome and MiSans.
## References
Vicanek, Martin. *A New Reverse IIR Filtering Algorithm*. (2022).
Redmon, Nigel. *Cascading filters*. (2016).
Fitzgerald, Derry. *Harmonic/percussive separation using median filtering*. (2010).