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.

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 JunoandPhaseshaperoscillator 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
.tunmicrotuning - 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
| Platform | Download |
|---|---|
| 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
| Format | Default 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
| Format | Default 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
| Format | Default 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
| 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; center 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 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,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.
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 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.
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:
| 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.
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 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.
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 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.
Reverse playback
- 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.
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
Lengthitem in theSEQmenu 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.
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).
Generative
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.
Transport and clock
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.
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
| Control | Where | What it does |
|---|---|---|
| On/off switch | Main panel | Takes the overdrive in and out |
DRIVE | Main panel | Drive amount into the model |
DRY/WET | Main panel | Blend between the dry 303 and the overdriven signal |
Model | OVD page | Picks the pedal or amp model |
Pre VCA | OVD page | Moves the overdrive before the amplitude envelope |
Disperse | OVD page | All-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:
- GuitarML ToneLibrary — the community tone repository; every tone is a
.jsonmodel. - Tone Library site — browse and download the tone packs.
- Proteus Tone Packs v1.0 — a single zip of compatible models.
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 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 |
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 exceptTeeBeehas 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 exceptTeeBee.Saturation Bias— the asymmetry of the driven circuit. It ramps in withFilter Saturationand 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 withFilter Saturation;Spicyexposes it inHi-Fimode only.Filter FM— audio-rate cutoff modulation. Unlike the LFO it runs fast enough to add sidebands and metallic ring; every model exceptTeeBee.Filter Feedback— the feedback high-pass corner of the diode filters, which sets how much of the low end feeds back.Res Trim—Spicyonly. 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—Spicyonly.Standardor the slower, more accurateHi-Fisolver, which models the diode nonlinearity per stage.Filter Tension—SpicyinHi-Fionly. Floppy to stiff resonance; how tightly the resonance peak is tied to the cutoff.Bass Comp—Spicyonly. 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 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 |
Square Model(TB-303) —Open303wavetable orCircuitpulse. TheCircuitpulse 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) and5 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) orFormant(vector-phaseshaping formant).Shape Drift(PhaseshaperRipple Saw/Formant) — slow, pitch-tracked movement that keeps the shape alive.Formant Split(PhaseshaperFormant) — 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%):
| 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 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:
- 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.
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:
| 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.
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 taketrue/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.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)".
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:
- 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.
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 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 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
.tunfile 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 (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 modeler by Keith Bloemer (seesrc/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.