This is a Free Roland TB-303 clone plugin. A Cmake JUCE port of Robin Schmidt`s Open303 with added features: a step sequencer ported from midilab`s Aciduino V2, a neural overdrive based on GuitarML and tons of DSP MODs implemented by the community.
This software is licensed under the GNU General Public License version 3 (GPLv3).
The Open303 engine part of this software is also licensed under the MIT License.
The Aciduino sequencer part of this software is also licensed under the MIT License.
The overdrive is based on the GuitarML neural amp modeller and its Chowdhury-DSP BYOD port, distributed under the GPLv3 like the rest of this project.
- The project as a whole is distributed under GPLv3 (see
LICENSE). src/dsp/open303/rosic_*and the other Open303 files are MIT, Copyright (c) 2009 Robin Schmidt (seesrc/dsp/open303/LICENSE).src/dsp/open303/dfl_DiodeLadderFilter.*,src/dsp/open303/dfl_TB303OutputNetwork.handsrc/dsp/open303/dfl_LFO.*are AGPL-3.0-or-later, Copyright (C) 2026 David Lowenfels (seesrc/dsp/open303/LICENSE-AGPL-3.0). Each file carries an SPDX header.src/sequencer/AcidSequencer303.handsrc/sequencer/Harmonizer.hare a JUCE port of Aciduino V2 (engine_303.cpp+harmonizer.cpp), MIT, Copyright (c) 2022 Romulo Silva.src/dsp/guitarml-byod/is a port of Chowdhury-DSP BYOD'sGuitarMLAmp, implementing the GuitarML LSTM amp modeller by Keith Bloemer (seesrc/dsp/guitarml-byod/LICENSE).
- TB-303 engine with the original Open303 voice, plus
Alpha JunoandPhaseshaperoscillator models. - Eight filter models: the TeeBee, Spicy, MissBehave, JuneBug, Wasabi, Hornet, SemiSweet and Oddity ladders/state-variable filters.
- Four-slot modulation matrix, each slot with its own source, destination and bipolar amount, plus a full LFO.
- Built-in 16-step acid sequencer with accent, slide, tie, mute, hammer and per-step reverse.
- Overdrive with modelled drive pedals/amps, separate drive and dry/wet, and pre-VCA routing.
- Assignable mod knobs, JSON presets and preset banks, and AnaMark
.tunmicrotuning.
The manual below describes the midilabv2 GUI theme (the default). The amadeusp and midilab themes drive the same engine with a different panel layout, so the parameter names are the same even where a control looks different.
Supports Windows, Linux and MacOS. You may find CLAP, VST3, LV2 and AU formats available to download. For VST2 plugin you need to compile it by your own self using vst2 sdk from Steinberg - vstsdk2.4.
MacOS Universal - Intel and ARM: jc303-macos_universal-plugins.zip
Windows Intel x64: jc303-windows_x64-plugins.zip
Linux Intel x64: jc303-linux_x64-plugins.zip
The platform zip pack will contain a folder per plugin format, just pick the format you want to install and copy the content of the folder to your OS plugin format folder.
MacOs De-Quarantine: MacOs users needs to de-quarantine plugin before load it into any DAW.
Open a terminal window and do the following
$ sudo xattr -rd com.apple.quarantine /Library/Audio/Plug-Ins/Components/JC303.componentThis de-quarantine example is for AU, please do the same for other formats you'll be using
| Control | What it does |
|---|---|
WAVEFORM |
Saw/square blend on the TB-303, Alpha Juno pulse morph, or Phaseshaper shape, depending on the oscillator model |
TUNING |
Master tune, roughly -700 to +700 cents; centre is A4 = 440 Hz. Right-click for the microtuning menu |
CUTOFF FREQ |
Filter cutoff |
RESONANCE |
Filter resonance |
ENVMOD |
Filter-envelope depth |
DECAY |
Filter-envelope (MEG) decay; its range changes with the MOD switch |
ACCENT |
Accent amount |
VOLUME |
Output level |
MOD switch |
Turns the modifications on or off |
DRIVE, DRY/WET + switch |
Overdrive |
| Two assignable knobs | Quick control of two MOD-page parameters (see Mod knobs) |
Everything the MOD switch controls is on the LCD MOD page (see Modifications page); the panel itself carries only the controls listed above. With the MOD switch off the engine is a stock TB-303: TeeBee filter, TB-303 oscillator, Open303 square, no LFO, no sub oscillator and the fixed 303 envelopes. The MOD page and the assignable knobs are inactive in that state. Switch MOD on to use the oscillator models, the other filters, the LFO/mod matrix and the mod knobs.
The display and the eight buttons under it are the menu:
PST,OVD,MOD,SEQselect the Presets, Overdrive, Modifications and Sequencer pages. The editor opens onPST.<<and>>move the cursor between rows on the current page.-and+step the selected row's value one increment (choice entries step one item at a time).- The large knob next to them sweeps the selected row's value.
- Click a row's label to open its picker: preset list, bank list, LFO waveform, filter model, oscillator model, modulation source/destination, and so on.
- Each page remembers its own cursor position when you switch pages.
MOD-page rows are greyed out and do nothing until the MOD switch is on. Rows that only apply to a particular filter or oscillator model are hidden while another model is selected, so the page stays short.
The MOD page is the full list of modifications, in this order. Rows marked with a model only appear while that filter or oscillator model is selected.
| Row | What it does |
|---|---|
Filter Model |
Selects the filter (see Filter models) |
Filter Morph |
Low-pass (0) to band-pass (0.5) to high-pass (1); every model but TeeBee |
Res Trim |
Component-tolerance loop gain, 0.5 = nominal; Spicy only |
Filter Quality |
Standard or the slower, more accurate Hi-Fi solver; Spicy only |
Filter Tension |
Floppy to stiff resonance; Spicy in Hi-Fi only |
Filter Saturation |
0 to +16 dB into the filter's saturating input; every model but TeeBee |
Saturation Bias |
Asymmetry of the driven circuit, ramps in with Filter Saturation (hidden on JuneBug and SemiSweet) |
Saturation Rail |
Ceiling of the driven circuit, ramps in with Filter Saturation; Spicy in Hi-Fi only |
Bass Comp |
Restores the low end the resonance pot loses; Spicy only |
Filter FM |
Audio-rate cutoff FM; every model but TeeBee |
Osc Model |
TB-303, Alpha Juno or Phaseshaper (see Oscillator models) |
Square Model |
Open303 wavetable or Circuit pulse; TB-303 only |
Square Drive |
Square edge drive / waveshaper sag; TB-303 only |
Juno Wave |
1 Saw, 2 Oct, 3 PW, 4 Hi Oct, 5 Dual; Alpha Juno only |
Super Detune |
Supersaw spread, 0 = one voice; Alpha Juno only |
Super Mix |
Centre/side voice balance; Alpha Juno only |
Shaper Mode |
Tri Mod, Ripple Saw or Formant; Phaseshaper only |
Shape Drift |
Slow pitch-tracked movement; Phaseshaper Ripple Saw / Formant |
Formant Split |
Turns one formant peak into two; Phaseshaper Formant |
Sub Osc |
Sub-oscillator level (see Sub oscillator) |
Sub Octave -2/-1 |
0 = two octaves down (a 25% pulse), 1 = one octave down (a square) |
Normal decay |
Amp-envelope decay of unaccented notes (30 ms–3 s) |
Accent decay |
Amp-envelope decay of accented notes (30 ms–3 s) |
Accent sweep |
Accent capacitor time constant; 15 ms is the stock 303, slower builds up over consecutive accents |
Filter Feedback |
Feedback high-pass corner of the diode filters |
Soft attack |
Amp-envelope attack time |
Slide time |
Slide/glide time |
LFO rate |
0.1–20 Hz |
LFO depth |
LFO amount |
LFO wave |
Triangle, Saw Up, Saw Down, Square, Random, Pink Noise |
LFO dest |
LFO destination |
LFO phase |
LFO start phase, 0–360° |
LFO key sync |
Restart the LFO on every note |
LFO contour |
Lag/slew the LFO shape (negative) or sharpen its edges (positive) |
Env dest, Env amount |
Filter-envelope modulation route (slot 2) |
Mod 3 source, Mod 3 dest, Mod 3 amount |
Free modulation route (slot 3) |
Mod 4 source, Mod 4 dest, Mod 4 amount |
Free modulation route (slot 4) |
The Normal decay, Accent decay and Soft attack rows shape the amp envelope; the main DECAY knob still sets the filter (MEG) decay. The LFO, envelope and free routes are described under LFO and modulation matrix.
The oscillator model is selected with Osc Model on the MOD page.
Osc Model |
Description | Model-specific controls |
|---|---|---|
TB-303 |
The original Open303 saw/square oscillator | Square Model (Open303 wavetable or Circuit pulse), Square Drive |
Alpha Juno |
Roland Alpha Juno DCO saw family, optionally stacked as a JP-8000-style supersaw | Juno Wave (1 Saw … 5 Dual), Super Detune, Super Mix |
Phaseshaper |
Single-oscillator JP-8000 triangle modulation, ripple supersaw and vector-phaseshaping formant | Shaper Mode (Tri Mod, Ripple Saw, Formant), Shape Drift, Formant Split |
Juno Wave picks one of the five hardware-derived saw shapes (plain, +1 octave chop, pulse-width chop, +3 octave chop, both chops). Super Detune spreads six side voices around the centre; Super Mix sets the centre/side balance. On Phaseshaper, the main WAVEFORM knob is the shape control, Shape Drift adds slow pitch-tracked movement, and Formant Split turns one formant peak into two.
The waveform knob changes meaning with the model, so a preset that relies on a particular shape should set the model and the waveform together.
The filter is selected with Filter Model on the MOD page:
Filter Model |
Origin |
|---|---|
TeeBee |
Open303's original TB-303 transistor ladder |
Spicy |
TB-303 diode ladder calibrated to a SPICE model of the real VCF (default when MOD is on) |
MissBehave |
Korg MS-20 / MS-10 Korg35 filter |
JuneBug |
Roland Juno-106 IR3109 with BA662 resonance |
Wasabi |
EDP Wasp CMOS-inverter / CA3080 filter |
Hornet |
Doepfer A-124 Wasp |
SemiSweet |
Oberheim SEM CA3080 / JFET filter |
Oddity |
ARP 4075 (Odyssey Mk III) four-pole cascade |
All models except TeeBee support Filter Morph: 0 is low-pass, 0.5 band-pass and 1 high-pass, and a modulation slot can move it. Filter Saturation drives the filter input; Saturation Bias and Saturation Rail shape the driven circuit (both ramp in with Saturation and are hidden where the real circuit does not use them). Filter FM adds audio-rate cutoff modulation.
The Spicy model also exposes the Devilfish-style controls: Res Trim (component-tolerance loop gain, 0.5 = nominal), Filter Quality (Standard or the slower, more accurate Hi-Fi solver), Filter Tension (Hi-Fi only: floppy to stiff resonance), and Bass Comp (restores the low end the real resonance pot loses). Filter Feedback (on the MOD page) sets the feedback high-pass corner for the diode filters.
TeeBee ignores the model-specific controls, so switching back to it is a quick way to hear the stock sound.
The modulation matrix has four routes. Each row on the MOD page has a destination and a bipolar amount (-100% to +100%):
| Slot | Source | Rows on the MOD page |
|---|---|---|
| 1 | LFO | LFO Dest, LFO Depth plus the LFO controls |
| 2 | Filter envelope | Env Dest, Env Amount |
| 3 | Selectable | Mod 3 Source, Mod 3 Dest, Mod 3 Amount |
| 4 | Selectable | Mod 4 Source, Mod 4 Dest, Mod 4 Amount |
Available sources:
| Source | Signal |
|---|---|
Off |
No modulation |
LFO |
Bipolar LFO output |
Env |
Filter envelope, mapped bipolar around its rest value |
Env+ |
Filter envelope, unipolar: 0 at rest, so pitch and other offsets settle back |
Accent |
Accent gate, 0 or 1 |
Key |
Keyboard position around MIDI note 48, ±2 octaves, follows slides |
Random |
A new bipolar value on every note |
Cutoff |
The cutoff knob position, 0 to 1 |
Available destinations: Cutoff, Volume, Pitch, Pulse Width, Resonance, Overdrive, Filter FM, Env Mod, Decay, Accent, Waveform, LFO Rate, LFO Depth and Filter Morph.
The LFO controls are LFO Rate (0.1–20 Hz), LFO Depth, LFO Wave (Triangle, Saw Up, Saw Down, Square, Random, Pink Noise), LFO Phase (start phase, 0–360 degrees), LFO Key Sync (restart the LFO on every note) and LFO Contour (negative values slew/lag the shape, positive values sharpen its edges). LFO Rate and LFO Depth can themselves be destinations, which is how you get one modulator to speed up or deepen another.
Amounts are bipolar. A negative amount inverts the source, which is useful for envelope-followed pitch drops, backwards filter sweeps and ducking.
Sub Osc sets the level of a square/pulse sub oscillator and Sub Octave -2/-1 chooses its pitch: 0 is two octaves down (a 25% pulse), 1 is one octave down (a square). It follows the played note and works with any oscillator model. Leave Sub Osc at 0 to keep the stock 303 sound.
The overdrive is a neural model of a drive pedal or amp, fed by the 303:
DRIVEandDRY/WETare on the main panel; the switch next to them turns the overdrive on and off.- The
OVDpage selects theModel, and hasPre VCAandDisperse. Modellists the built-in models plus any user models found in<Documents>/midilab/JC303/overdrive_models/(.jsonfiles).Pre VCAmoves the overdrive before the amplitude envelope, so the envelope shapes the distortion instead of the distortion flattening the envelope.Disperseadds an all-pass stage before the drive. It changes the phase relationship of the harmonics without changing the level much, which is useful for tightening or smearing the attack.
- Pitch bend spans one octave up and down (MIDI pitch wheel).
- Mod wheel (MIDI CC 1) drives the first assignable mod knob directly; the knob on screen follows the wheel.
- Space bar starts/stops the sequencer when the plugin runs its own clock (standalone, or
Sync Mode=Internal). In a plugin withHostorMidi Clocksync, space is left to the host. - The sequencer sends its notes to the host on MIDI channel 1, so you can route them to another instrument.
JC303 ships with a full acid step sequencer ported from Aciduino V2. It is a 16-step monophonic sequencer clocked sample-accurately from the audio thread, playing the built-in 303 engine and sending MIDI out to the host. Note length is the authentic 303 half-step (50%) gate, and slide/tie bridge correctly from the last step back to the first. The sequencer panel and manual below target the midilabv2 GUI theme.
Each of the 16 steps is a column of controls:
| Row | Control | Meaning |
|---|---|---|
step |
LED | Selects the step to edit; also shows the playing step, the pitch playhead and the active pattern length |
rest |
toggle | Note ON (toggle up) or rest (toggle down); a red frame means the step is reversed |
accent |
micro-toggle | Step plays with accent; blue means the step is muted |
slide |
micro-toggle | Slide on a note step, tie on a rest; blue means the step is hammered |
| pitch name | label | The stored note of the step (C2, F#6, ...) |
Below the grid are the transport buttons (PLAY/STOP, REC, REST, CLEAR, gen), the generative mod knobs, and the on-screen octave keyboard.
- The selected step blinks. The step currently playing lights red.
- The pitch playhead lights amber. It is normally the same step as the playhead;
Pitch Rot/Pitch Lencan move it to a different step. - Steps beyond the active pattern length stay editable but do not play and their LEDs are dim.
- The sequencer note range starts at C0 (MIDI note 24), matching the TB-303's lowest step.
- Left-click a step LED to select the step to edit. Clicking a step at or beyond the active pattern length snaps the selection to the last active step.
- Note/rest toggle: each step is a note by default; toggle it off to make it a rest, on to re-activate it.
- Accent / Slide / Tie are per-step toggles. A tie carries the previous note over, and handles wrap-around from the last step to the first.
- The keyboard always shows the note of the selected step.
The step toggles also have secondary states, set with Shift-click:
| Shift-click on | Sets |
|---|---|
| a step LED | reverse for that step (turns a rest into a reversed note) |
| the accent micro-toggle | mute: the step is choked and its accent is cleared |
| the slide micro-toggle | hammer: the next note starts at its pitch immediately, without the usual slide glide (clears slide) |
PLAY/STOP |
starts in reverse, or flips the playback direction while running |
A blue accent toggle is a mute; a blue slide toggle is a hammer. Shift-clicking again clears the secondary state.
- Shift-click
PLAY/STOPstarts the sequencer playing backwards, or flips direction while it is running. The play button lights red while reverse playback is active. - In reverse playback the steps run last to first and each note's amp/filter/accent envelope is reversed (a swell up to the attack instead of a decay).
- A step's own
reverseflag flips it back to a forward envelope, so you can mix forward and reversed notes inside a reversed pattern.
- Right-click any step LED to set the pattern length from 1 to 16 (the clicked step becomes the last step of the pattern). Steps beyond the length are kept but stay silent.
- Length can also be set with the
Lengthitem in theSEQmenu page.
- Click a key to set the note of the selected step.
- Mouse wheel over the keyboard transposes the note of the selected step by one octave per notch (the octave of the keyboard follows the note).
- In record mode the rec cursor is the target for both actions.
Turn REC on to enter serial (step-by-step) entry. The record cursor starts at the currently selected step and advances one step per entered event, wrapping at the pattern length.
- Keyboard: press a key to record its note and advance. Existing accent/slide/tie flags on the step are kept.
- External MIDI: velocity 100 or above records the step with accent; striking a second note while one is still held records a slide (legato); tapping the sustain pedal (CC64, 127 on) records a rest.
RESTbutton: in record mode it records a rest and advances the cursor; outside record mode it turns the selected step into a rest and moves the selection to the next step.CLEARbutton resets the whole track to rests (all accents, slides and ties removed).
The gen button generates a random pattern across all 16 steps using:
| Knob | Range (default) | Meaning |
|---|---|---|
FILL |
0–100 (80) | % chance each step is ON (not a rest) |
ACC |
0–100 (50) | % chance of accent on an ON step |
SLIDE |
0–100 (30) | % chance of slide on an ON step |
TIE |
0–100 (100) | % chance of tie on a rest step |
TONES |
1–12 (4) | Number of pitch classes to snap to (1 = single note) |
LOW |
0–127 (20) | Lowest MIDI note in the random pitch range |
RANGE |
0–127 (48) | Range above LOW of the random pitches |
Hold a modifier while clicking gen to keep part of the current pattern:
| Click | Result |
|---|---|
gen |
New rhythm and new pitches |
Shift + gen |
New pitches, same rhythm |
Alt + gen |
New rhythm, same pitches |
The sequencer is briefly muted while a pattern is generated so no stray notes play. Generating keeps the pattern length intact but overwrites the steps within it.
Undo/redo covers gen, CLEAR and the other pattern-changing actions: Ctrl/Cmd+Z undoes, Shift+Ctrl/Cmd+Z redoes, and the SEQ page has an Undo row.
PLAY/STOPstarts and stops the sequencer.- In a plugin the default
Sync ModeisHost; the standalone app defaults toInternal. These are only startup defaults — a saved project restores its own setting. - An incoming MIDI Start while the sequencer is parked switches
Sync ModetoMidi Clock, so it follows the external clock from then on. TheStart Modestill decides whether that Start begins playback.
The SEQ page in the LCD exposes:
| Row | Meaning |
|---|---|
Length |
Pattern length, 1–16 |
Tempo |
Internal BPM, 20–300; active only in Internal sync mode |
Sync Mode |
Internal (free-running at Tempo), Host (follows the DAW transport position and tempo), or Midi Clock (follows external MIDI Start/Stop/Clock messages) |
Start Mode |
Transport (starts on host transport or MIDI Start) or Note Trigger (starts automatically on the first incoming note, even while stopped) |
Transpose |
Semitone offset, -24 to +24; rewrites the stored notes, stopping where a note would leave the MIDI range |
Shift |
Moves the steps earlier, 0–15; wraps at the pattern length |
Pitch Rot |
Rotates the pitches through the note steps, 0–15; rests and flags stay on their steps. Wraps at the pattern length |
Pitch Len |
Off or 1–16: the note steps cycle through the first N pitches across bars (polymeter) |
Swing |
MPC-style swing, 50–75%; off-beat 16ths land later in the 8th-note pair |
CPU Timing |
Adds the TB-303 CPU's interrupt timing and gate jitter; only active while MOD is on |
Undo |
Undo the last pattern change |
Transpose, Shift and Pitch Rot are offsets: changing one rewrites the pattern by the difference from the previous value. gen and Clear reset the offsets they regenerate, so a new pattern starts from zero.
When the host loops, the sequencer follows the loop: at the loop end it releases held notes and re-anchors to the loop start instead of stopping. This also covers hosts (Cubase, Ardour) that implement looping as a brief stop and restart. The transport keeps running across the wrap.
The sequencer sends note on/off messages to the host on MIDI channel 1, so its output can drive another instrument while the built-in engine plays.
Beneath the panel sit two assignable rotary knobs that give you quick, always-in-reach
control over any parameter from the Modifications (MOD) page — handy for the ones you
tweak the most (filter model, normal decay, LFO rate, a mod amount, ...).
How to assign:
- Switch the editor to the
MODmenu page and select the item you want on the knob (e.g. "Filter Saturation"). - Shift-click the knob (hold the Shift key and click it).
- The knob now controls that parameter; a short label appears under the knob.
Notes:
- The
MODswitch must be on for the knobs to affect the sound; withMODoff they are greyed out. - A knob can only grab a Modifications-page parameter, not a main-panel control.
- The same parameter can't be on both knobs at once — assigning it to the second knob is a no-op.
- Normal clicks still turn the knob; shift-click is the only quick-assign gesture.
- The on-knob labels are shortened to fit (
Fltr Morph,Fltr FM,Sup Detune, ...); the full name is on theMODpage. - MIDI CC 1 (mod wheel) moves the first knob, and the knob on screen follows the wheel.
- The assignment is saved with the plugin state, and presets can set
modKnob1/modKnob2for any sound (see Presets below). The default preset assignsFilter Morphto knob 1 andFilter FMto knob 2.
JC303 ships with a factory bank of presets. Each preset is its own .json file in the
user's presets directory, so you can edit a sound in any text editor and the next bank
load picks the change up. The GUI theme is midilabv2.
The default program is Open303 Clean, a stock 303 sound. It loads when the plugin
starts and the editor opens on the PST (Presets) page, so a new instance is ready to
play or to browse from. The factory bank also showcases the engine: Super JP,
Ripple Lead, Formant Talk, Hornet Morph, Wasp Sting, Spicy Devil,
Sub Tracker, Vowel Sync, Mind Bender, Miss Scream, Muff Stomp, Rail Crusher,
Squelch, Stiff Spring, Floppy Drop, Dice Acid and Hoover.
The Presets page in the LCD shows six rows:
| Row | Action |
|---|---|
Preset |
Pick a preset with the knob or inc/dec (also opens a picker on click) |
Bank |
Pick a preset bank |
Save |
Save the current sound into the selected preset |
New |
Create a new preset from the current sound |
Rename |
Rename the selected preset (keeps its sound) |
Delete |
Delete the selected preset (asks for confirmation first) |
New, Rename and Delete are confirmed on the keyboard:
- New / Rename — type the name (blinking block cursor over the last character),
Enterto confirm.ESCor moving the cursor cancels; a blank name is rejected. - Delete — the first
Enterarms the delete ("Press Enter to confirm" blinks); a secondEnteractually deletes the file. - After each operation the result (
Saved/Created/Renamed/Deleted) blinks for three seconds, then the cursor returns to thePresetrow with the affected preset selected.
Presets live under <Documents>/midilab/JC303/presets/ (your OS's Documents folder).
On first run the factory bank is seeded from the copies embedded in the binary;
afterwards every sound is loaded from disk.
A preset file is plain JSON:
{
"name": "Hoover",
"modKnob1": "superDetune",
"modKnob2": "lfoDepth",
"values": {
"volume": 0.75,
"switchModState": true,
"oscModel": "Alpha Juno",
"...": "..."
}
}name— the display name on the Preset row.modKnob1/modKnob2— the parameters on the two mod knobs (mod-wheel driven knob 1). They must be Modifications-page parameters, not main-panel controls.values— each sound parameter you want to set. Choices take the name shown in the plugin ("Alpha Juno","Env+"; an index also works), switches taketrue/false, and knobs take the parameter's own value. Anything you leave out falls back to that parameter's default.
Open303 Clean is always first; the rest of a bank is listed in natural file-name order, not
by display name. To reorder a bank, rename its files with a number prefix:
2_zulu.json comes before 10_alpha.json. Save keeps a preset's file name; New and
Rename name the file after the preset.
To tweak a preset without touching the plugin, open its .json in any text editor,
change the values entries, and save. The plugin reads presets from disk each time a
bank loads, so switch the Bank back and forth (or restart the plugin) to pick up your
edits. Keep the file valid JSON — a preset that fails to parse is skipped, and a bank
with no loadable presets falls back to Open303 Clean.
For new sounds, it's easiest to dial the patch in the plugin and use Save / New
(see the Presets page above) rather than writing values by hand — the plugin records
exact parameter values for you.
Every preset carries its own volume, so each sound recalls its own output level and
no preset is louder or quieter than the last when you step through them. When creating
a preset, aim for -6 dB for the final sound — measured as the peak level of the
patch in your DAW's meter (or the plugin host you're using), not a number on this
plugin's knob. The knob's scale is its own, so judge by what your DAW reads, not by
a position on the dial.
Why -6 dB:
- Consistent loudness when switching presets. If one program sits near full scale and the next at half that, stepping through them in a mix jumps audibly and risks a sudden clipping spike. A shared target keeps changes musical instead of startling.
- Headroom sits at the mix bus, not inside the synth. A preset peaking at full scale leaves no room for several voices to sum, or for the track plus the rest of the arrangement to add up before the master; -6 dB leaves a clear margin for that summing and for a limiter or master chain later.
- Resonant and accent-heavy 303 patches get louder than they look. Filter resonance and accents push peaks up past a quiet hand-tuned patch; testing at the loudest moment (hard accent, resonance up) and settling on a -6 dB peak keeps the patch from suddenly overloading when that moment arrives.
There's no "-6 dB" stored in the JSON — volume is the plugin's own scale. Create the
sound, watch your DAW's meter, adjust the plugin's volume until the loudest notes peak
around -6 dB, then Save.
Any subdirectory you create in presets/ full of .json files becomes a selectable
Bank (listed alphabetically after factory). Use a separate folder per collection,
set, or project. Switching banks swaps the presets in memory; the list always mirrors
the current bank's folder.
- Every write is atomic: a
.json.tmpis written first and moved over the target only on success, so a crash can never leave a half-written preset. - Filenames are safe slugs of the display name, lowercased:
"Dice Acid"→dice_acid.json,"My Cool Patch (1)"→my_cool_patch_1.json. - Colliding names get OS-style suffixes:
"Name","Name (1)","Name (2)".
Call for preset banks. JC303's factory bank belongs to the community as much as to the developers. Build a bank, send it back, and the strongest sounds will ship as factory presets — credited to you.
How to take part:
- Create a folder for your bank in
<Documents>/midilab/JC303/presets/(for exampleAcid Lab) and pick it on the Presets page'sBankrow. - Fill it with your best sounds using New / Save. Give each sound a clear name, and set the two mod knobs with Shift-click so the preset opens with its most useful controls under your fingers.
- Aim for a -6 dB peak in your DAW (see the level guidance above), so your sounds sit at the same loudness as the factory bank.
- Export the bank's
.jsonfiles and send them in: open a pull request that adds the bank's folder to the repository, or attach a zip to a GitHub issue/discussion. Keep the folder name as the bank name and include one line about what the bank explores (an oscillator model, a filter, the mod matrix, the overdrive...).
Selection:
- The best preset from each submitted bank is guaranteed one of the factory slots. The remaining slots go to the best of the rest.
- Up to 20 community presets are selected for the factory bank. If more than 20 banks arrive, the maintainers pick the 20 strongest, keeping one per bank wherever possible.
- Sounds are judged on the -6 dB target, musical usefulness, originality, and how well they show off the engine.
- Contributors are credited in the release notes.
Presets are plain parameter data, so a submitted bank stays yours to share; sending it in grants the project permission to include the selected sounds in the factory bank.
JC303 loads AnaMark .tun (v2) scale files. Right-click the Tuning knob and choose Load .tun... or Reset to 12-TET. The active scale name shows under the knob.
[Exact Tuning]takes precedence and needsBaseFreqplus all 128 notes. Without it,[Functional Tuning]needsInitEqual, and itsNotelines apply in file order.- Scale Workshop designs scales in the browser and exports them as
.tun. - If a file is invalid, an error dialog shows the line and the cause, and the current scale stays loaded.
- The Tuning knob spans about -700 to +700 cents and snaps to A4 = 440 Hz at its centre detent.
- The Tuning knob transposes the loaded scale, the same way it transposes 12-TET.
- The scale is saved with the project as absolute frequencies, so the
.tunfile is not needed to reopen it.
AnaMark .tun support by Andrej Schmitt (@Megagoth1702).
Generate the cmake project build files first for the OS of your choice.
| Variable | Description | Default |
|---|---|---|
| GUI | Select GUI theme interface to use | midilabv2 |
Available themes: midilabv2 | amadeusp | midilab
To change JC303 GUI theme add the following to the first cmake call: -D GUI=midilabv2
To generate an Xcode project, run:
cmake -B build -G Xcode -D CMAKE_OSX_ARCHITECTURES=arm64\;x86_64 -D CMAKE_OSX_DEPLOYMENT_TARGET=10.13The -D CMAKE_OSX_ARCHITECTURES=arm64\;x86_64 flag is required to build universal binaries.
The -D CMAKE_OSX_DEPLOYMENT_TARGET=10.13 flag sets the minimum MacOS version to be supported.
We suggest to install Cygwin with git and a terminal to compile JC303.
Find the PATH of your visual studio compiler and cmake installation and add to your .profile
# Visual Studio 18 / MSVC 14.51
export PATH="$PATH:/cygdrive/c/Program Files/Microsoft Visual Studio/18/Community/Common7/IDE/CommonExtensions/Microsoft/CMake/CMake/bin"
export PATH="$PATH:/cygdrive/c/Program Files/Microsoft Visual Studio/18/Community/VC/Tools/MSVC/14.51.36231/bin/Hostx64/x64"source .profileTo generate a Visual Studio 2026 (18) project, run:
cmake -B build -G "Visual Studio 18" -A x64Install the dependecies:
sudo apt install build-essential gcc cmake libx11-dev libxrandr-dev libxinerama-dev libxcursor-dev libfreetype6-dev libasound2-devTo generate a Linux CMake project, run:
cmake -B buildTo compiled from the command line, run:
cmake --build build --config ReleaseBuild x86_64 release (default behavior)
docker build --build-arg RELEASE_ARCH=X86_64 -t jc303-linux-builder-x86_64 .Build arm64 release
docker build --build-arg RELEASE_ARCH=ARM64 -t jc303-linux-builder-arm64 .Run – mounts current directory → /jc303
docker run -it --rm -v "$(pwd):/jc303" jc303-linux-builderNo distribution of VST2 plugin binaries is allowed without a license, but if you have the sdk and the license to use it just copy the vstsdk2.4/ SDK folder to the root of this project before run cmake.
Binary release for MacOS, Windows and LinuxGraphical User InterfaceInternal parameters for engine tunning -Inspired on Devilfish ModOverdriveStep Sequencer- Sequencer Patterns
Preset Support