Plugin Cookbook.

Describe the effect you want to hear, and get a plugin running on your MOD device. The Cookbook is a set of instructions the AI assistant of your choice reads to write a MOD plugin for you. No programming needed.

A pedalboard of plugins made with the Plugin Cookbook
A pedalboard of plugins made with the Cookbook, by Munverzagt.

What you need.

An AI assistantAny assistant that can open web links: Claude, ChatGPT, Gemini or others. A free account can be enough.
A MOD deviceA MOD Dwarf, Duo or Duo X, with MOD OS 1.13.3 or later, and its USB cable.
A computer and a browserTo talk to the assistant and to use the MOD Cloud Builder. Nothing to install, no account on the Builder.

Step by step.

  1. 1
    Open a conversation with an AI assistant

    Use the AI assistant of your choice: Claude, ChatGPT, Gemini or another. It must be one that can open web links.

  2. 2
    Send it the cookbook

    Paste this link into the conversation. It holds the instructions the assistant follows to write a MOD plugin.

    https://github.com/mod-audio/mod-plugin-cookbook
    If your assistant can’t open links, paste the text of this prompt instead. Same result.
  3. 3
    Describe the plugin you want

    In your own words. The assistant confirms the idea and proposes the details with you: name, category, mono or stereo, and the knobs with their ranges.

  4. 4
    Save the .mk file

    The assistant writes one file, ending in .mk. Save it with the exact file name it gives you.

  5. 5
    Connect your MOD device and open the Builder

    Plug your MOD Dwarf, Duo or Duo X into your computer with the USB cable, and open the MOD Cloud Builder in a desktop browser. If it doesn’t find your device, try Firefox.

    https://builder.mod.audio/buildroot
  6. 6
    Upload, build, install

    Upload the .mk file and start the build. When it’s done, click Install. Tick “shareable persistent link” if you want a link others can use to install it too.

  7. 7
    Play it, then refine it

    The plugin appears in your device’s web interface, ready for any pedalboard. Judge it by ear and ask the assistant for changes: each change is a new .mk file and a new upload. Two or three rounds usually do it.

Home screen of the MOD Cloud Builder
The MOD Cloud Builder.
Buildroot screen of the MOD Cloud Builder, where the .mk file is uploaded
Uploading the .mk file.

What to ask for.

Name a kind of effect, describe a sound, or have an open conversation about sound design. A few ways people start:

“A tape-saturation distortion with drive and tone knobs.”“A slow tremolo with rate and depth.”“A wavefolder that gets harsher as it’s pushed.”“A chorus that doesn’t add lows.”
Say which controls you wantKnobs, switches and their ranges. The assistant proposes some, but your words decide.
Ask for friendly defaultsMany players never turn a knob. The plugin should sound good the moment it’s loaded.
Test it properlyEvery control should respond, with no crackles, no instability and no clipping at sensible settings.

Made by the community.

Players are already making their own effects and sharing them on the forum. Some of them, with their makers’ own names:

A whole board, made for himself
A whole board, made for himselfby Munverzagt

More than a dozen plugins with their own names: Orbit, a compressor and sustainer; Chapel, organ and chime tones; Carousel, a vibe and rotary; Vesper, an auto-swell; Nimbus, a reverb; and Finish, a cleanup EQ.

Read the thread →
Parlor and Harbor
Parlor and Harborby Munverzagt

A simple drive with a boost, and a reverb built on the same engine as Nimbus.

Read the thread →
Factotum Octave Fuzz Drive
Factotum Octave Fuzz Driveby Niels

Overdrive, fuzz and a gated splutter, with an octave-up on its own footswitch.

Read the thread →Install it on your device →
Gravel Slide
Gravel Slideby Niels

A fuzz, built entirely in a free chat with an AI assistant.

Read the thread →
Temporal Rift
Temporal Riftby Niels

A sustainer: hold a chord and it loops the sustained part, with rise, tail and a tempo-synced tremolo. Here in Andrea Del Signore’s pedalboard.

Read the thread →Install it on your device →
CV Macro 4 and 8by Lipi

One control that moves four or eight parameters at once, through MOD’s control voltage plugins.

Read the thread →

All plugins made with the Cookbook →

Share what you makeWhen you upload, tick “shareable persistent link”. The Builder gives you a link that anyone with a MOD device can open to install the same plugin.Then post it in the Cookbook category on the forum, so others can try it and give feedback.Post on the forum →Discuss the Cookbook →
Current limitsEverything lives in one file: nothing to install, nothing to push anywhere. That keeps it simple, and it sets some limits:
  • One source file per plugin.
  • No external libraries beyond DPF.
  • No custom pedal graphics: Cookbook plugins use the standard interface. The pedal faces in some of the examples above were designed separately by their makers.
  • A change means regenerating the whole file and uploading it again.
  • About 1,000 lines of DSP code is a practical maximum.
Other ways to build plugins →Developer resources →

Stay in the loop.

New plugins, MOD OS releases and what the community is building, by email.