omx-plugins

The effects of the OpenMixer console, as plugins you can load in any host: CLAP for Bitwig, REAPER, Carla, openmixer and every other CLAP host, and LV2 for Ardour, Carla, MOD and Zynthian, the MOD GUI included.

The DSP inside each one is the console's own (the omx-dsp library), so a plugin sounds the same in your DAW as on the desk, sample for sample. Each plugin is drawn from one declaration: its CLAP parameters, its LV2 ports and its MOD GUI cannot disagree.

The plugins

omx balancer

Plus the host's bypass.

omx chorus

Plus the host's bypass.

omx clipper

Plus the host's bypass.

omx comp

Plus the host's bypass.

omx deesser

Plus the host's bypass.

omx delay

With one tap the delay is the single-tap echo. Raising Taps adds the second to fourth reads of the same line, each with its own time, gain and pan; the feedback comes from the longest engaged tap, so a pattern repeats as a whole.

Plus the host's bypass. The tone filter holds the same corner at every sample rate, so a session moved from 48 to 96 kHz sounds the same.

omx drive

Plus the host's bypass.

omx dyneq

Plus the host's bypass.

omx eq8

Plus the host's bypass, which is the whole EQ's switch. Every band and filter starts off, so a freshly loaded instance passes the signal untouched.

omx eq16

Plus the host's bypass, which is the whole EQ's switch. Every band and filter starts off, so a freshly loaded instance passes the signal untouched.

omx eq32

Plus the host's bypass, which is the whole EQ's switch. Every band and filter starts off, so a freshly loaded instance passes the signal untouched.

omx flanger

Plus the host's bypass.

omx geq

Plus the host's bypass.

omx glue

Plus the host's bypass.

omx keyed-gate

The console's gate, keyed: the stereo signal is gated while the detector listens to a second, mono input, the key (an LV2 sidechain port; in CLAP a second input port). With nothing routed to the key, or Key set to Self, it is the ordinary self-keyed gate.

Plus the host's bypass. An attack under 0.5 ms engages the 4x detector path, which adds 72 frames of latency, reported to the host; otherwise the latency is zero. Its LV2 URI, ports and defaults are those of the keyed gate bundle the OpenMixer console used to ship, so a session saved with that bundle loads this one.

omx limiter

Plus the host's bypass.

omx loudlevel

Plus the host's bypass.

omx multiband

Plus the host's bypass.

omx phaser

Plus the host's bypass.

omx pitch

Plus the host's bypass.

omx plosive

Plus the host's bypass.

omx reverb

Plus the host's bypass.

omx rotary

Plus the host's bypass.

omx spring

Plus the host's bypass.

omx strip

Five stages, each omx-dsp's instance face of the console's own kernel, run one after the other; each has its own switch:

Order (0 to 119) picks the order of the five stages: 0 is the desk's input > filters > gate > EQ > comp, and the rest follow in lexicographic order (1 is input > filters > gate > comp > EQ, ... 119 is comp > EQ > gate > filters > input). Plus the host's bypass. The latency reported is the sum of the stages': the gate's and the compressor's 4x detector paths while they are engaged, else zero.

0.3.0 changed the parameter list (the Input and Filters switches, the gate's knee, hold and hysteresis, the compressor's kind, mix and detector oversampling, five-stage orders): a session saved with 0.2.0 does not load as it was, though at 0.2.0's settings the strip sounds the same, sample for sample.

omx suboct

Plus the host's bypass.

omx transient

Plus the host's bypass.

omx tremolo

Plus the host's bypass.

omx upward

Plus the host's bypass.

Parameters

docs/plugins/README.md lists every plugin with a page of its own: its ids, its audio ports, the pages a host shows (LV2 port groups, CLAP modules) and a table of every parameter with its unit, range, default, steps or values and flags. The pages are generated from the declarations by tools/params-doc.mjs (make params-doc), and make check-params-doc fails when a committed page differs from what they say.

Factory presets

Every plugin ships a set of factory presets, one JSON file each, in presets/<plugin id>/<preset id>.json (for example presets/org.openmixer.drive/amp-tube.json). The omx-plugins package installs them read only under /usr/share/omx/presets/, where the console's preset library lists them as the factory group. A file names the plugin, the preset's id and name, and every parameter by symbol, unit and plain value (a choice also by its label); no value leaves its declared range. tools/gen-presets.mjs writes the files and make presets checks them.

Install

On Fedora, from the FreeMixer package channel:

sudo dnf install https://www.openmixer.org/rpm/openmixer-release.noarch.rpm
sudo dnf install omx-plugins

On Debian bookworm or trixie, Raspberry Pi OS and Zynthian:

curl -fsSLO https://www.openmixer.org/deb/openmixer-release.deb && sudo apt install ./openmixer-release.deb
sudo apt install omx-plugins

omx-plugins installs both formats. To take only the one your host loads, install omx-plugins-clap (CLAP hosts) or omx-plugins-lv2 (LV2 hosts) instead. The plugins land where hosts look without configuration (/usr/lib/clap on every distribution, the path the CLAP specification gives; /usr/lib64/lv2 on Fedora, /usr/lib/lv2 on Debian). Rescan plugins in your host and look for the omx plugins under openmixer.

Every release also carries the packages on its GitHub release page, and for a Zynthian without the apt channel, omx-plugins-zynthian-<version>-arm64.tar.gz: copy its lv2/ bundles into /zynthian/zynthian-plugins/lv2 and rescan the LV2 plugins from Zynthian's admin menu.

Projects that build on the plugins' parameters and instance code install the headers instead of copying them: omx-plugins-devel on Fedora, omx-plugins-dev on Debian (they land in /usr/include/omx-plugins). Each plugin's descriptor, its parameters in omx-contract's words, is in omx-plugins-contract, which omx-plugins and the devel package require: files in omx-contract's contract directory (/usr/share/omx-contract/contract.d/3/omx-plugins/) that a host reads at run time. The code of each unit the param-contract extension serves is omx-contract's (3/omx-contract/param-contract.json). The devel package carries libomxplugins.a (pkg-config omxplugins): every plugin's CLAP face in one static library, for a host that runs them in its own process without loading .clap files. <omx-plugins/omx_clap_static.h> lists their entries by CLAP id:

#include <omx-plugins/omx_clap_static.h>

const clap_plugin_entry_t *e = omx_clap_static_find("org.openmixer.delay");
e->init("");
const clap_plugin_factory_t *f = e->get_factory(CLAP_PLUGIN_FACTORY_ID);
const clap_plugin_t *delay = f->create_plugin(f, host, "org.openmixer.delay");

OMX_CLAP_STATIC_PLUGINS (OMX_CLAP_STATIC_COUNT rows of {id, entry}) walks them all, and omx_clap_static_entry is all of them behind one CLAP entry and one plugin factory.

To build from source, see BUILDING.md.

Licence

GPL-3.0-or-later. See LICENSE.