Skip to main content

JC-303

Unlock the iconic sound of Roland's TB-303 with JC-303, a faithful emulation of the legendary acid house and techno synth, available free of charge as a VST2, VST3, LV2, CLAP, and AU plugin for Linux, macOS, or Windows DAWs.

It is a CMake/JUCE port of Robin Schmidt's Open303 with a step sequencer ported from midilab's Aciduino V2, a neural overdrive based on GuitarML, and a large set of DSP mods implemented by the community.

JC-303 UI

note

This manual 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.


Key Features​

  • TB-303 engine with the original Open303 voice, plus Alpha Juno and Phaseshaper oscillator models
  • Eight filter models — 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 modeled drive pedals/amps, separate drive and dry/wet, and pre-VCA routing
  • Assignable mod knobs, JSON presets and preset banks, and AnaMark .tun microtuning
  • AI Overdrive section — GuitarML-driven pedal and cabinet emulations using machine learning models
  • Open-source — all DSP and GUI source code freely available under GPLv3
  • Cross-platform — Windows, macOS, and Linux
  • Plugin versatility — VST2, VST3, LV2, CLAP, and Audio Unit formats

Download​

PlatformDownload
Windows (Intel x64)jc303-0.14.0-windows_x64-plugins.zip
macOS (Universal — Intel + ARM)jc303-0.14.0-macos_universal-plugins.zip
Linux (Intel x64)jc303-0.14.0-linux_x64-plugins.zip

You may find CLAP, VST3, LV2 and AU formats in the packages. The VST2 plugin has to be compiled by yourself using the VST2 SDK from Steinberg (vstsdk2.4).


Installation​

Each platform ZIP contains a folder per plugin format. Pick the format you want to install and copy the content of the folder to your OS plugin format folder.

Windows​

FormatDefault Path
VST2 (.dll)C:\Program Files\VSTPlugins or C:\Program Files\Steinberg\VSTPlugins
VST3 (.vst3)C:\Program Files\Common Files\VST3
CLAP (.clap)C:\Program Files\Common Files\CLAP
LV2 (.lv2)%APPDATA%\LV2 or C:\Program Files\Common Files\LV2

macOS​

FormatDefault Path
Audio Unit (.component)/Library/Audio/Plug-Ins/Components
VST2 (.vst)/Library/Audio/Plug-Ins/VST
VST3 (.vst3)/Library/Audio/Plug-Ins/VST3
CLAP (.clap)/Library/Audio/Plug-Ins/CLAP
LV2 (.lv2)/Library/Audio/Plug-Ins/LV2

macOS De-Quarantine​

macOS Gatekeeper blocks unsigned plugins. De-quarantine after copying:

# Audio Unit
sudo xattr -rd com.apple.quarantine /Library/Audio/Plug-Ins/Components/JC303.component

# VST3
sudo xattr -rd com.apple.quarantine /Library/Audio/Plug-Ins/VST3/JC303.vst3

# VST2
sudo xattr -rd com.apple.quarantine /Library/Audio/Plug-Ins/VST/JC303.vst

# CLAP
sudo xattr -rd com.apple.quarantine /Library/Audio/Plug-Ins/CLAP/JC303.clap

# LV2
sudo xattr -rd com.apple.quarantine /Library/Audio/Plug-Ins/LV2/JC303.lv2

The AU example is just that — repeat it for every format you installed.

Linux​

FormatDefault Path
VST2 (.so)~/.vst, /usr/lib/vst, /usr/local/lib/vst
VST3 (.vst3)~/.vst3, /usr/lib/vst3, /usr/local/lib/vst3
LV2 (.lv2)~/.lv2, /usr/lib/lv2, /usr/local/lib/lv2
CLAP (.clap)~/.clap, /usr/lib/clap, /usr/local/lib/clap

Locations can vary depending on distribution and user configuration — check your DAW's plugin path settings. After copying, rescan plugins in your DAW.


Controls​

Main panel​

ControlWhat it does
WAVEFORMSaw/square blend on the TB-303, Alpha Juno pulse morph, or Phaseshaper shape, depending on the oscillator model
TUNINGMaster tune, roughly -700 to +700 cents; center is A4 = 440 Hz. Right-click for the microtuning menu
CUTOFF FREQFilter cutoff
RESONANCEFilter resonance
ENVMODFilter-envelope depth
DECAYFilter-envelope (MEG) decay; its range changes with the MOD switch
ACCENTAccent amount
VOLUMEOutput level
MOD switchTurns the modifications on or off
DRIVE, DRY/WET + switchOverdrive
Two assignable knobsQuick control of two MOD-page parameters (see Mod knobs)

Everything the MOD switch controls is on the LCD MOD page (see Mods); 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.

LCD menu​

The display and the eight buttons under it are the menu:

  • PST, OVD, MOD, SEQ select the Presets, Overdrive, Modifications and Sequencer pages. The editor opens on PST.
  • << 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.

Performance controls​

  • 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 with Host or Midi Clock sync, 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.

Step Sequencer​

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.

Layout​

Each of the 16 steps is a column of controls:

RowControlMeaning
stepLEDSelects the step to edit; also shows the playing step, the pitch playhead and the active pattern length
resttoggleNote ON (toggle up) or rest (toggle down); a red frame means the step is reversed
accentmicro-toggleStep plays with accent; blue means the step is muted
slidemicro-toggleSlide on a note step, tie on a rest; blue means the step is hammered
pitch namelabelThe 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.

Step display​

  • 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 Len can 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.

Editing steps​

  • 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 onSets
a step LEDreverse for that step (turns a rest into a reversed note)
the accent micro-togglemute: the step is choked and its accent is cleared
the slide micro-togglehammer: the next note starts at its pitch immediately, without the usual slide glide (clears slide)
PLAY/STOPstarts 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.

Reverse playback​

  • Shift-click PLAY/STOP starts 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 reverse flag flips it back to a forward envelope, so you can mix forward and reversed notes inside a reversed pattern.

Setting the pattern length​

  • 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 Length item in the SEQ menu page.

Seq keyboard​

  • 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.

Record mode​

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.
  • REST button: 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.
  • CLEAR button resets the whole track to rests (all accents, slides and ties removed).

Generative​

The gen button generates a random pattern across all 16 steps using:

KnobRange (default)Meaning
FILL0–100 (80)% chance each step is ON (not a rest)
ACC0–100 (50)% chance of accent on an ON step
SLIDE0–100 (30)% chance of slide on an ON step
TIE0–100 (100)% chance of tie on a rest step
TONES1–12 (4)Number of pitch classes to snap to (1 = single note)
LOW0–127 (20)Lowest MIDI note in the random pitch range
RANGE0–127 (48)Range above LOW of the random pitches

Hold a modifier while clicking gen to keep part of the current pattern:

ClickResult
genNew rhythm and new pitches
Shift + genNew pitches, same rhythm
Alt + genNew 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.

Transport and clock​

  • PLAY/STOP starts and stops the sequencer.
  • In a plugin the default Sync Mode is Host; the standalone app defaults to Internal. These are only startup defaults — a saved project restores its own setting.
  • An incoming MIDI Start while the sequencer is parked switches Sync Mode to Midi Clock, so it follows the external clock from then on. The Start Mode still decides whether that Start begins playback.

The SEQ page in the LCD exposes:

RowMeaning
LengthPattern length, 1–16
TempoInternal BPM, 20–300; active only in Internal sync mode
Sync ModeInternal (free-running at Tempo), Host (follows the DAW transport position and tempo), or Midi Clock (follows external MIDI Start/Stop/Clock messages)
Start ModeTransport (starts on host transport or MIDI Start) or Note Trigger (starts automatically on the first incoming note, even while stopped)
TransposeSemitone offset, -24 to +24; rewrites the stored notes, stopping where a note would leave the MIDI range
ShiftMoves the steps earlier, 0–15; wraps at the pattern length
Pitch RotRotates the pitches through the note steps, 0–15; rests and flags stay on their steps. Wraps at the pattern length
Pitch LenOff or 1–16: the note steps cycle through the first N pitches across bars (polymeter)
SwingMPC-style swing, 50–75%; off-beat 16ths land later in the 8th-note pair
CPU TimingAdds the TB-303 CPU's interrupt timing and gate jitter; only active while MOD is on
UndoUndo 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.


Overdrive​

The overdrive is a neural model of a real drive pedal or amp, fed by the 303's output. It comes from GuitarML research into machine-learning amp modelling, using the ChowDSP BYOD DSP implementation. A trained model captures how the real hardware responds — how it distorts, and how it reacts to level — and recreates it in real time.

Overdrive controls​

ControlWhereWhat it does
On/off switchMain panelTakes the overdrive in and out
DRIVEMain panelDrive amount into the model
DRY/WETMain panelBlend between the dry 303 and the overdriven signal
ModelOVD pagePicks the pedal or amp model
Pre VCAOVD pageMoves the overdrive before the amplitude envelope
DisperseOVD pageAll-pass stage before the drive

Pre VCA routes the overdrive ahead of the amp envelope, so the envelope shapes the distortion instead of the distortion flattening the envelope. Unaccented and accented notes then drive the model by different amounts, and slides and decays shape the tone as they fall. Leave it off to drive the model with a steady-level signal and let the envelope act afterwards, as on the stock signal path.

Disperse adds an all-pass filter before the drive. It shifts the phase of the harmonics without changing the overall level much, which tightens or smears the attack and can make the distortion feel more or less "in front". Small amounts are subtle; higher amounts push the model into a different response.

Models​

JC-303 ships with a factory set of built-in drive-pedal and amp models. Model on the OVD page lists them, and clicking the row opens the picker like the other choice rows.

Adding and removing models​

User models are plain .json files, read from a folder in your Documents:

<Documents>/midilab/JC303/overdrive_models/

The folder is created the first time you run the plugin. To install a model, copy its .json file into that folder; to remove one, delete the file. Installed models then appear in the Model list on the OVD page.

Over 180 additional models are available from the GuitarML community:

Unzip a pack and copy the models you want into overdrive_models/. The models are compatible across GuitarML plugins, so anything built for the same architecture loads here.


Mods​

The MOD switch on the main panel turns the modifications on and off. With it off the engine is a stock TB-303 — TeeBee filter, TB-303 oscillator, Open303 square, the fixed 303 envelopes, no LFO and no sub oscillator. With it on, every modification below becomes available on the LCD MOD page and the two assignable mod knobs come to life.

The MOD page is a vertical list of rows; step through it with the LCD buttons and click a row's label to open its picker. Rows that only apply to a particular filter or oscillator model are hidden while another model is selected, so the page stays short. The rows are grouped below.

Filter mods​

Filter Model selects the filter. Each model is a different circuit, so the same pattern and knob positions sound very different across them:

Filter ModelOrigin
TeeBeeOpen303's original TB-303 transistor ladder
SpicyTB-303 diode ladder calibrated to a SPICE model of the real VCF (default when MOD is on)
MissBehaveKorg MS-20 / MS-10 Korg35 filter
JuneBugRoland Juno-106 IR3109 with BA662 resonance
WasabiEDP Wasp CMOS-inverter / CA3080 filter
HornetDoepfer A-124 Wasp
SemiSweetOberheim SEM CA3080 / JFET filter
OddityARP 4075 (Odyssey Mk III) four-pole cascade

Beyond the choice of model, the filter has its own set of mods:

  • Filter Morph — sweeps the response from low-pass (0) through band-pass (0.5) to high-pass (1). Every model except TeeBee has it, and a modulation slot can move it, which is how you get a filter that tracks a pattern's pitch or an envelope. A negative amount inverts the sweep.
  • Filter Saturation — drives the filter's input from 0 to +16 dB, with level compensation so the output stays put as you push it. It adds the input-stage colour of the driven circuit. Every model except TeeBee.
  • Saturation Bias — the asymmetry of the driven circuit. It ramps in with Filter Saturation and is hidden on the models whose real circuit does not use it (JuneBug, SemiSweet).
  • Saturation Rail — the ceiling of the driven circuit. Also ramps in with Filter Saturation; Spicy exposes it in Hi-Fi mode only.
  • Filter FM — audio-rate cutoff modulation. Unlike the LFO it runs fast enough to add sidebands and metallic ring; every model except TeeBee.
  • Filter Feedback — the feedback high-pass corner of the diode filters, which sets how much of the low end feeds back.
  • Res Trim — Spicy only. Component-tolerance loop gain, 0.5 = nominal; it nudges the resonance up or down the way a real unit's parts spread would.
  • Filter Quality — Spicy only. Standard or the slower, more accurate Hi-Fi solver, which models the diode nonlinearity per stage.
  • Filter Tension — Spicy in Hi-Fi only. Floppy to stiff resonance; how tightly the resonance peak is tied to the cutoff.
  • Bass Comp — Spicy only. Restores the low end the real resonance pot loses as resonance rises.

TeeBee ignores the model-specific controls, so switching back to it is a quick way to hear the stock sound.

Oscillator mods​

Osc Model swaps the oscillator:

Osc ModelDescriptionModel-specific controls
TB-303The original Open303 saw/square oscillatorSquare Model (Open303 wavetable or Circuit pulse), Square Drive
Alpha JunoRoland Alpha Juno DCO saw family, optionally stacked as a JP-8000-style supersawJuno Wave (1 Saw … 5 Dual), Super Detune, Super Mix
PhaseshaperSingle-oscillator JP-8000 triangle modulation, ripple supersaw and vector-phaseshaping formantShaper Mode (Tri Mod, Ripple Saw, Formant), Shape Drift, Formant Split
  • Square Model (TB-303) — Open303 wavetable or Circuit pulse. The Circuit pulse is a modelled TB-303 square with pitch-tracked pulse width and band-limited edges, so it stays clean as the pitch moves.
  • Square Drive (TB-303) — square edge drive and waveshaper sag, for a fatter, more compressed square.
  • Juno Wave (Alpha Juno) — one of the five hardware-derived saw shapes: 1 Saw (plain), 2 Oct (+1 octave chop), 3 PW (pulse-width chop), 4 Hi Oct (+3 octave chop) and 5 Dual (both chops).
  • Super Detune (Alpha Juno) — spreads six side voices around the center. 0 is a single voice; higher values give the JP-8000-style supersaw width.
  • Super Mix (Alpha Juno) — the center/side balance of the stacked voices.
  • Shaper Mode (Phaseshaper) — Tri Mod (triangle modulation), Ripple Saw (ripple supersaw) or Formant (vector-phaseshaping formant).
  • Shape Drift (Phaseshaper Ripple Saw / Formant) — slow, pitch-tracked movement that keeps the shape alive.
  • Formant Split (Phaseshaper Formant) — turns one formant peak into two.

On Phaseshaper, the main WAVEFORM knob is the shape control. 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.

Envelope and timing​

These mods shape the amp envelope and the note timing; the main DECAY knob still sets the filter (MEG) decay.

  • Normal decay — amp-envelope decay of unaccented notes, 30 ms–3 s.
  • Accent decay — amp-envelope decay of accented notes, 30 ms–3 s, so accents can ring out longer than the rest.
  • Soft attack — a short amp-envelope attack instead of the near-instant 303 attack.
  • Slide time — the glide time used when a step slides into the next.
  • Accent sweep — the accent capacitor time constant. 15 ms is the stock 303; slower values build the accent up over consecutive accents instead of snapping each time.

Sub oscillator​

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.

LFO and modulation matrix​

The modulation matrix has four routes. Each row on the MOD page has a destination and a bipolar amount (-100% to +100%):

SlotSourceRows on the MOD page
1LFOLFO Dest, LFO Depth plus the LFO controls
2Filter envelopeEnv Dest, Env Amount
3SelectableMod 3 Source, Mod 3 Dest, Mod 3 Amount
4SelectableMod 4 Source, Mod 4 Dest, Mod 4 Amount

Available sources:

SourceSignal
OffNo modulation
LFOBipolar LFO output
EnvFilter envelope, mapped bipolar around its rest value
Env+Filter envelope, unipolar: 0 at rest, so pitch and other offsets settle back
AccentAccent gate, 0 or 1
KeyKeyboard position around MIDI note 48, ±2 octaves, follows slides
RandomA new bipolar value on every note
CutoffThe 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 mods, each explained:

  • LFO rate — 0.1–20 Hz.
  • LFO depth — how far the LFO moves its destination.
  • LFO wave — Triangle, Saw Up, Saw Down, Square, Random, Pink Noise.
  • LFO dest — the LFO's destination, from the list above.
  • LFO phase — the LFO's start phase, 0–360°.
  • LFO key sync — restarts the LFO on every note, so each note begins at the same point in the cycle.
  • LFO contour — negative values slew/lag the shape, positive values sharpen its edges.
  • Env dest, Env amount — the filter-envelope route (slot 2).
  • Mod 3 source, Mod 3 dest, Mod 3 amount — free route (slot 3).
  • Mod 4 source, Mod 4 dest, Mod 4 amount — free route (slot 4).

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, so a negative amount inverts the source — useful for envelope-followed pitch drops, backwards filter sweeps and ducking.


Mod knobs​

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:

  1. Switch the editor to the MOD menu page and select the item you want on the knob (e.g. "Filter Saturation").
  2. Shift-click the knob (hold the Shift key and click it).
  3. The knob now controls that parameter; a short label appears under the knob.

Notes:

  • The MOD switch must be on for the knobs to affect the sound; with MOD off 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 the MOD page.
  • 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 / modKnob2 for any sound (see Presets below). The default preset assigns Filter Morph to knob 1 and Filter FM to knob 2.

Presets​

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.

Presets page​

The Presets page in the LCD shows six rows:

RowAction
PresetPick a preset with the knob or inc/dec (also opens a picker on click)
BankPick a preset bank
SaveSave the current sound into the selected preset
NewCreate a new preset from the current sound
RenameRename the selected preset (keeps its sound)
DeleteDelete 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), Enter to confirm. ESC or moving the cursor cancels; a blank name is rejected.
  • Delete — the first Enter arms the delete ("Press Enter to confirm" blinks); a second Enter actually deletes the file.
  • After each operation the result (Saved / Created / Renamed / Deleted) blinks for three seconds, then the cursor returns to the Preset row with the affected preset selected.

Preset files​

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 take true / false, and knobs take the parameter's own value. Anything you leave out falls back to that parameter's default.

Preset order​

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.

Editing presets by hand​

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.

Volume level guidance for preset creators (-6 dB target)​

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.

Banks​

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.

Safe file handling​

  • Every write is atomic: a .json.tmp is 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)".

Share your presets​

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:

  1. Create a folder for your bank in <Documents>/midilab/JC303/presets/ (for example Acid Lab) and pick it on the Presets page's Bank row.
  2. 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.
  3. 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.
  4. Export the bank's .json files 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.


Microtuning​

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 needs BaseFreq plus all 128 notes. Without it, [Functional Tuning] needs InitEqual, and its Note lines 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 center 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 .tun file is not needed to reopen it.

AnaMark .tun support by Andrej Schmitt (@Megagoth1702).


Building from Source​

JC-303 uses CMake and JUCE. Clone the repository and generate build files for your platform.

git clone https://github.com/midilab/jc303.git
cd jc303

Dependencies​

Ubuntu / Debian:

sudo apt install build-essential gcc cmake libx11-dev libxrandr-dev libxinerama-dev libxcursor-dev libfreetype6-dev libasound2-dev

macOS: Xcode command line tools

Windows: Visual Studio (Cygwin with git and a terminal is recommended)

Generate Build Files​

macOS (Universal binary):

cmake -B build -G Xcode -D CMAKE_OSX_ARCHITECTURES=arm64\;x86_64 -D CMAKE_OSX_DEPLOYMENT_TARGET=10.13

Windows (Visual Studio 2026 / 18):

Find the PATH of your Visual Studio compiler and cmake installation and add them to your .profile:

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"

Then:

cmake -B build -G "Visual Studio 18" -A x64

Linux:

cmake -B build

Compile​

cmake --build build --config Release

GUI Themes​

Choose a theme at CMake configuration time with -D GUI=<theme>. The default is midilabv2.

cmake -B build -D GUI=midilabv2

Available themes: midilabv2 (default) | amadeusp | midilab.

Docker Build​

Build an x86_64 release (default):

docker build --build-arg RELEASE_ARCH=X86_64 -t jc303-linux-builder-x86_64 .

Build an arm64 release:

docker build --build-arg RELEASE_ARCH=ARM64 -t jc303-linux-builder-arm64 .

Run — mounts the current directory to /jc303:

docker run -it --rm -v "$(pwd):/jc303" jc303-linux-builder

VST2​

No distribution of VST2 plugin binaries is allowed without a license, but if you have the SDK and the license to use it, copy the vstsdk2.4/ SDK folder to the root of the project before running CMake.


Roadmap​

  • ✅ Binary releases for macOS, Windows, Linux
  • ✅ Graphical user interface
  • ✅ Internal engine tuning parameters (Devilfish inspired)
  • ✅ Overdrive
  • ✅ Step sequencer
  • 🔄 Step sequencer patterns
  • ✅ Preset support

Community​

JC-303 is a community-driven project open to contributions in coding, testing, bug reporting, design, and ideas.


License​

The project as a whole is distributed under the GNU General Public License v3 (see LICENSE). The Open303 engine part is also licensed under the MIT License, and the Aciduino sequencer part is likewise MIT.

Licensing by file​

  • 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 (see src/dsp/open303/LICENSE).
  • src/dsp/open303/dfl_DiodeLadderFilter.*, src/dsp/open303/dfl_TB303OutputNetwork.h and src/dsp/open303/dfl_LFO.* are AGPL-3.0-or-later, Copyright (C) 2026 David Lowenfels (see src/dsp/open303/LICENSE-AGPL-3.0). Each file carries an SPDX header.
  • src/sequencer/AcidSequencer303.h and src/sequencer/Harmonizer.h are 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's GuitarMLAmp, implementing the GuitarML LSTM amp modeler by Keith Bloemer (see src/dsp/guitarml-byod/LICENSE).

Roland and TB-303 are registered trademarks of Roland Corporation. JC-303 is not affiliated with or endorsed by Roland Corporation.