FxmeFX

A small collection of JUCE audio-effect plugins by FX-Mechanics.

Each effect is a self-contained DSP class plus a matching GUI component, wrapped in a minimal AudioProcessor / AudioProcessorEditor so they can be used both as standalone plugins (the targets built here) and as building blocks inside larger projects (the same classes are reused, for example, in the FxmeSampler drum kits).

Plugins

Name	Plugin code	Description
FxmeCompressor	COMP	Compressor with peak/RMS detector, three release modes (Linear / Opto / Vintage), soft-knee and gain-reduction meter.
FxmeEqualizer	EQUL	5-band parametric EQ. Each band switches between Lowpass, Highpass, Peak, Low Shelf and High Shelf, with an interactive frequency-response graph.
FxmeTube	TUBE	Valve / tube saturation with four models (Standard, Dynamic, Triode, Class-AB), bias, tone and power-supply sag.
FxmeTransient	TRNS	SPL-style transient designer using the Differential Envelope Technique - independent attack and sustain shaping.
FxmeStereoDelay	SDEL	Tempo-synced stereo delay with cross-feedback and a state-variable lowpass in the feedback path.
FxmeConvolReverb	CREV	Convolution reverb (WDL engine) with six embedded impulse responses, length / shape / start-offset shaping, plus an "External…" slot for loading a user IR.
FxmeCab	CABN	Stereo cabinet/IR loader. Two independent mono-IR slots (one per output channel), 19 embedded cabinet IRs, output gain.
FxmeOct	OCTV	Boss OC-2-style monophonic octaver. Schmitt-trigger zero-crossing + ÷2 / ÷4 flip-flops, envelope-tracked square synthesis, dry / -1 oct / -2 oct mix, detection LPF and tone LPF. Zero latency, stable on bass.

All plugins build as VST3, AU (macOS) and a Standalone application, and also as headless Pure Data externals — see the dedicated section below.

Screenshots

FxmeCompressor	FxmeEqualizer
FxmeTube	FxmeTransient
FxmeStereoDelay	FxmeConvolReverb
FxmeCab	FxmeOct

Pure Data externals

Each plugin also ships as a Pd signal external that reuses the exact same DSP path as the VST/AU build — only the GUI is stripped and parameters are exposed as Pd float inlets instead of host-automation parameters. The Pd build excludes any "load IR from file" feature; both fxmecab~ and fxmeconvolreverb~ use only their embedded built-in impulse responses.

Binaries are named fxme<plugin>~.pd_linux / .pd_darwin / .dll.

Common conventions

• Inlets 0 and 1 are always audio L and audio R (signal inlets).
• Inlets 2..N+1 are float inlets, one per parameter, in the order listed below. Send a float, the value is forwarded to the underlying JUCE parameter on the next audio block.
• Outlets 0 and 1 are audio L and audio R.
• Boolean parameters use 0 = off, 1 = on. Choice parameters use the zero-based index of the option name.
• Each plugin has a top-level On switch that bypasses processing when 0; most default to off so you have to enable them explicitly.

fxmecompressor~

Inlet	Parameter	Range	Default
2	On	0 / 1	0
3	Pre Gain (dB)	-24 … 24	0
4	Attack (ms)	0.1 … 100	10
5	Release (ms)	10 … 1000	100
6	Threshold (dB)	-60 … 0	0
7	Ratio	1 … 20	1
8	Knee (dB)	0 … 24	0
9	Release Mode	0 = Linear, 1 = Opto, 2 = Vintage	0
10	Peak / RMS mix	0 (pure peak) … 1 (pure RMS)	0
11	Make-up Gain (dB)	-24 … 24	0

fxmeequalizer~

Two global parameters, then five bands. Each band has Type / Freq / Q / Gain in that order. Band 1 defaults to Low Shelf, bands 2–4 to Peak, band 5 to High Shelf, but every band can be reassigned to any of the five filter types.

Inlet	Parameter	Range	Default
2	On	0 / 1	0
3	Post Gain (dB)	-24 … 24	0
4	Band 1 (LS) Type	0 = LP, 1 = HP, 2 = Peak, 3 = LowShelf, 4 = HighShelf	3
5	Band 1 (LS) Freq	20 … 20000	100
6	Band 1 (LS) Q	0.1 … 10	1
7	Band 1 (LS) Gain	-24 … 24	0
8	Band 2 (B1) Type	0 … 4	2
9	Band 2 (B1) Freq	20 … 20000	500
10	Band 2 (B1) Q	0.1 … 10	1
11	Band 2 (B1) Gain	-24 … 24	0
12	Band 3 (B2) Type	0 … 4	2
13	Band 3 (B2) Freq	20 … 20000	2000
14	Band 3 (B2) Q	0.1 … 10	1
15	Band 3 (B2) Gain	-24 … 24	0
16	Band 4 (B3) Type	0 … 4	2
17	Band 4 (B3) Freq	20 … 20000	3500
18	Band 4 (B3) Q	0.1 … 10	1
19	Band 4 (B3) Gain	-24 … 24	0
20	Band 5 (HS) Type	0 … 4	4
21	Band 5 (HS) Freq	20 … 20000	5000
22	Band 5 (HS) Q	0.1 … 10	1
23	Band 5 (HS) Gain	-24 … 24	0

fxmetube~

Inlet	Parameter	Range	Default
2	On	0 / 1	0
3	Drive (dB)	0 … 40	0
4	Bias	0 … 0.5	0
5	Tone	-1 … 1	0
6	Sag	0 … 1	0.5
7	Output (dB)	-20 … 20	0
8	Model	0 = Standard, 1 = Dynamic, 2 = Triode, 3 = Class AB	0

fxmetransient~

Attack/Sustain are signed amounts in percent (negative = attenuate, positive = boost).

Inlet	Parameter	Range	Default
2	On	0 / 1	0
3	Pre Gain (dB)	-24 … 24	0
4	Attack (%)	-100 … 100	0
5	Sustain (%)	-100 … 100	0
6	Output Gain (dB)	-24 … 24	0
7	Character	0 = Soft, 1 = Standard, 2 = Hard	1

fxmestereodelay~

Inlet	Parameter	Range	Default
2	On	0 / 1	1
3	Delay L (s)	0 … 2	0.5
4	Delay R (s)	0 … 2	0.75
5	Feedback L (dB)	-60 … 6	-6
6	Feedback R (dB)	-60 … 6	-6
7	Cross Feedback (dB)	-60 … 6	-60
8	Filter Cutoff (Hz)	20 … 20000	20000
9	Filter Q	0.1 … 10	0.707
10	Dry Gain (dB)	-60 … 6	0
11	Wet Gain (dB)	-60 … 6	-6

fxmeconvolreverb~

Six built-in impulse responses: 1 = Council Chamber, 2 = Forest short, 3 = Forest long, 4 = Rectangular room small, 5 = Rectangular room medium, 6 = Rectangular room large. The "External IR file" slot present in the VST is not exposed in the Pd build.

Inlet	Parameter	Range	Default
2	On	0 / 1	1
3	IR (built-in index)	1 … 6	1
4	Length	0 … 1	1
5	Shape	0 = Fast Exp, 1 = Linear, 2 = Slow Log	0
6	Start Offset (ms)	-100 … 100	0
7	Dry Gain (dB)	-60 … 6	-60
8	Wet Gain (dB)	-60 … 6	0

fxmecab~

Each output channel is convolved with an independently selectable mono impulse response. The 19 built-in cabinet IRs are indexed 1 … 19 in the order they appear in Source/Cab/CMakeLists.txt.

Inlet	Parameter	Range	Default
2	On	0 / 1	1
3	IR L (index)	1 … 19	1
4	IR R (index)	1 … 19	2
5	Output Gain (dB)	-24 … 24	0

fxmeoct~

Bass-friendly OC-2-style octaver. Tune Detect just above the lowest fundamental you expect to track (≈80–120 Hz on a 5-string low B, ≈200–300 Hz on guitar low E).

Inlet	Parameter	Range	Default
2	On	0 / 1	1
3	Dry (dB)	-60 … 12	0
4	-1 Octave (dB)	-60 … 12	-6
5	-2 Octaves (dB)	-60 … 12	-60
6	Detect cutoff (Hz)	60 … 1500 (skewed, ~log scale)	400
7	Tone cutoff (Hz)	300 … 10000 (skewed, ~log scale)	2000

Repository layout

FxmeFX/
├── CMakeLists.txt              # root: builds every plugin
├── Source/
│   ├── Compressor/             # Compressor.{h,cpp} + CompressorComponent.{h,cpp}
│   │                           # + PluginProcessor / PluginEditor / CMakeLists.txt
│   ├── Equalizer/
│   ├── Tube/
│   │   └── img/                # tube.png / tube_bw.png (embedded as binary data)
│   ├── Transient/
│   ├── StereoDelay/
│   ├── ConvolReverb/
│   │   └── ir/                 # built-in impulse responses (embedded as binary data)
│   ├── Cab/
│   │   └── IR/                 # built-in cabinet impulse responses (embedded as binary data)
│   ├── Oct/                    # Boss-style frequency-division octaver
│   └── VuMeter/                # shared VU-meter DSP + component
├── WDL/                        # WDL submodule (FFT, convolution engine, resampler)
└── .github/workflows/          # CI: per-OS builds + tag-driven release

Prerequisites

JUCE and the FxmeJuceTools user-module are expected as siblings of this repository (CI mirrors the same layout):

<workspace>/
├── FxmeFX/                                  # this repo
├── JUCE/                                    # https://github.com/juce-framework/JUCE
│   └── usermodules/
│       └── FxmeJuceTools/                   # https://github.com/odoare/FxmeJuceTools (its module/ subdir)
└── ...

Quick setup:

git clone https://github.com/juce-framework/JUCE.git ../JUCE
git clone https://github.com/odoare/FxmeJuceTools.git /tmp/_fxme
mkdir -p ../JUCE/usermodules
mv /tmp/_fxme/module/FxmeJuceTools ../JUCE/usermodules/FxmeJuceTools

git submodule update --init --recursive          # pulls in WDL

Linux system dependencies

sudo apt install -y \
    libasound2-dev libx11-dev libxrandr-dev libxinerama-dev \
    libxcursor-dev libfreetype-dev libfontconfig1-dev libgl1-mesa-dev

Building

All plugins from the repository root

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --parallel

Built artefacts land in build/Source/<Plugin>/Fxme<Plugin>_artefacts/Release/.

A single plugin from the root

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DPLUGIN=Compressor
cmake --build build --parallel

PLUGIN accepts: Compressor, Equalizer, Tube, Transient, StereoDelay, ConvolReverb, Cab, Oct.

A single plugin standalone

Each plugin's CMakeLists.txt also works on its own — useful when iterating on one effect:

cmake -S Source/Compressor -B Source/Compressor/build -DCMAKE_BUILD_TYPE=Release
cmake --build Source/Compressor/build --parallel

Pure Data externals on Windows

On Linux and macOS the Pd externals link with undefined symbols and Pd resolves the m_pd.h ABI at load time. MSVC won't do that — its linker needs an import library. Point CMake at bin/pd.lib from a Pd-vanilla Windows install:

cmake -B build -S . -G "Visual Studio 17 2022" `
    "-DFXME_PD_LIB=C:/Program Files/Pd/bin/pd.lib"
cmake --build build --config Release --target FxmeCompressor_pd

CI fetches Pd-vanilla automatically; only local Windows builds need this.

Releases

Pushing a version tag like v0.1.0 triggers release.yml, which builds every plugin on Linux (x86_64 + arm64), macOS (universal arm64+x86_64) and Windows (x86_64), zips them per platform, and publishes a GitHub Release with the artefacts attached.

git tag v0.1.0
git push origin v0.1.0

License

FxmeFX is released under the GNU Lesser General Public License, version 3 (LGPL-3.0) - see LICENSE.

Vendored / external code keeps its own terms:

• WDL - zlib-style license (see WDL/WDL/LICENSE.md).
• JUCE - used per its end-user license; the GPL build is the one exercised here.
• FxmeJuceTools - MIT.