Collection of MAX gen~ based audio plugins used in MOD Audio.
Stored in a single source code repository to make it easy for contributors and MOD staff to add and maintain these plugins.
This source code repository has the following contents:
- custom-ttl - LV2 ttl files modified by hand, based on the generated DPF output, that adds a bit more information and meta-data to a plugin
- dpf - the plugin framework used to get CLAP, LV2, VST2, VST3 formats from a single implementation;
for MOD we only care about the LV2 format for now - max-gen - custom code that integrates the gen~ exported code in DPF
- plugins - gen~ exported plugins, each including the exported code plus a custom
DistrhoPluginInfo.hfor plugin meta-data and a README supplied by the author - presets - optional, LV2 presets to be included on the MOD plugin store builds of each plugin
This repository builds plugins as present in the plugins folder.
Each folder should follow the naming convention of "brandname-pluginame", with a single dash as separator and no spaces or special characters.
Inside each plugin folder there are 4 files:
- DistrhoPluginInfo.h
- gen_exported.cpp
- gen_exported.h
- README.md
The first file is meant for the plugin framework, it sets up branding, plugin categories and audio port count. It is safe to copy this file to another plugin for a starting point, but then make sure to edit the fields as necessary. The URI of the plugin must match the folder name in the style of "urn:maxgen:brandname:pluginname" (so keep the "urn:maxgen:" and change the rest) Take special attention to make sure the number of audio inputs and outputs match the MAX gen~ patch side.
Then we have the MAX gen~ gen_exported.cpp and gen_exported.h exported C++ code, which we store directly as-is.
And finally a readme just to give some details on the plugin and any relevant information.
For building you will need a POSIX-compliant compiler (GCC or Clang) plus GNU Make.
Building is a simple as running make after cloning this repository, assuming you have the needed tools installed.
Note that this repository uses git submodules, so cloning with git clone --recursive is required.
After building you will find CLAP, LV2, VST2 and VST3 plugin builds in a newly created ./bin directory.
Alternatively you can download nightly builds from the generated GitHub actions.
If you already have "bootstrapped" mod-plugin-builder before, building for e.g. MOD Dwarf is as simple as:
make moddwarf
Change moddwarf to modduo or modduox if applicable.
After building, you can directly push the bundle into a MOD unit over USB by running:
make modpush