playgrid.ccRead tutorial

Tutorial 043 / SuperCollider

Build Dune Reach in SuperCollider

Build Dune Reach in SuperCollider with subtractive keys, explicit envelopes and the sound-shaping chain explained in the guide.

5 stepsSubtractive KeysSuperCollider

Listen to the finished sound

Download WEBM ↓

Follow the synthesis steps in order. Use the audio examples and device settings alongside the instructions.

Step 01 / 5

Build the first oscillator and touch contour

Select ~soundStage = 1 and evaluate the full script at the end of this guide. Wait for the instrument-ready message before playing.

Set ~soundStage = 1 in the full script. Use rect at -7 dB with pulse width 49% when applicable. The contour has 0.008 s attack, 2.12 s exponential decay to 0.15 sustain and 0.572 s release. Multiply by velocity^2; this explicit power curve interprets the source velocity response. Keep the signal centered before adding effects.

SuperCollider control Value
Source Rect, -7.0 dB; width 49 %
Amplitude A/D/S/R 0.008 / 2.12 / 0.15 / 0.572
Amplifier / instrument -6.0 dB / -7.0 dB
Velocity power 2.0

Sound after step 1 — WebM/Opus

Next: Add the second oscillator and resonant contour →

Step 02 / 5

Add the second oscillator and resonant contour

Set ~soundStage = 2 in the full script. Add sine at -22 dB, tuned by 1 octaves. Use a Low-pass 24dB/oct interpretation with 564 Hz base cutoff, 2.3 octave envelope depth and 0.7 octave-per-octave pitch tracking. The contour opens then settles quickly while the amplitude remains. Smooth input drive interprets Sym1; the ladder or second-order lowpass is a different circuit. The 0 Hz LFO, where enabled, restarts per note rather than running freely.

SuperCollider control Value
Second source Sine; -22 dB; width not used
Filter base / source resonance 564 Hz / 0.16
Filter A/D/S/R 0.005 / 0.32 / 0.08 / 0.25
Envelope / key / LFO depth 2.3 / 0.7 / 0 octaves
LFO rate 0 Hz
Filter input shape tanh(input × 1.4) / 1.4

For MoogFF, multiply the stated source resonance amount by four to obtain its 0–4 gain argument (limited to 3.95). The complete script gives this gain expression beside each cutoff.

Sound after step 2 — WebM/Opus

Next: Add moving stereo chorus →

Step 03 / 5

Add moving stereo chorus

Set ~soundStage = 3 in the full script. Move two delay taps around 12 ms by ±2.4 ms at 0.44 Hz, with opposite phases and 18% wet mix. Highpass only the wet inputs at 180 Hz to leave the direct low body clear. Scale side information by 1; tap feedback is 0. These explicit tap depths interpret the source Amount and ensemble movement rather than copy the internal algorithm. Sustained notes reveal slow pitch interference.

SuperCollider control Value
Tap center / excursion 12 / ±2.4 ms
Rate / wet 0.44 Hz / 18%
Wet highpass 180 Hz
Width / feedback 1 / 0
Warmth shaping 0% smooth-drive interpretation

Sound after step 3 — WebM/Opus

Next: Surround the tone with a damped room →

Step 04 / 5

Surround the tone with a damped room

Set ~soundStage = 4 and evaluate the full block. Feed the preceding signal into FreeVerb2, using its fully wet output and the dry/wet routing shown in the script. The room continues after individual note envelopes release. Predelay separates the initial articulation from the diffuse tail; the external wet mix controls how far that tail moves forward.

The SuperCollider room value is 0.579344 and damping is 0.71875. These dimensionless settings are choices for this algorithm, rather than equivalent values for Ableton decay or Csound feedback and damping. More damping darkens the circulating highs. Any input filters and mid/side width changes in this stage retain their own explicit settings in the full script.

SuperCollider room control Value
FreeVerb2 internal mix 1, wet output only
Room 0.579344
Damping 0.71875
Predelay 12 ms
External room wet 17%
SuperCollider control Value
Room side multiplier 1
Room input cuts Off

Sound after step 4 — WebM/Opus

Next: Set the final width and gain →

Step 05 / 5

Set the final width and gain

Set ~soundStage = 5 in the full script. Use 3.6 dB gain after the effects. Scale the side signal by 1, preserving the center. Apply LeakDC DC removal with coefficient 0.995. The fixed ~soundOutputScale gain follows the complete effect chain at every stage. The effects Synth reads the stereo bus after the note group, and continues through note releases.

SuperCollider control Value
Final gain 3.6 dB
Width 1 × side
Bass side cutoff Off
DC removal LeakDC, coefficient 0.995

Sound after step 5 — WebM/Opus

Audio & settings ↓

Audio & settings

Audio recordings and settings for this tutorial.

Full SuperCollider script

The complete Dune Reach instrument uses stock SuperCollider units. Set ~soundStage from 1 to 5 and evaluate the entire block again to select a cumulative stage. Wait for the ready message; ~soundNote.(60, 0.8, 1) plays MIDI 60 at velocity 0.8 with a one-second held duration. Held duration controls when release begins, while each source's decay and modulation continue independently. ~soundStop.() frees the active instrument and its effects. This block replaces the previously installed PlayGrid instrument in the same interpreter.

(
~soundStage = 5;
~soundOutputScale = 2.98587;
~soundRelease = 0.572;
~soundNames = (motion: \pgDuneReachMotion, voice: \pgDuneReachVoice, effects: \pgDuneReachEffects);

~soundDefs = [
    SynthDef(\pgDuneReachMotion, { |out=0| Out.kr(out, DC.kr(0)) }),
    SynthDef(\pgDuneReachVoice, { |out=0, midi=60, velocity=0.8, gate=1, startMidi=60|
        var stage = ~soundStage;
    var aAmp = 0, aAmpDecay = 0, aAmpGate = 0, aL = 0, aR = 0, aSecond = 0, aSource = 0, iHz = 0;
    var iVelocity = 0, kCut = 0, kFilter = 0, kFilterDecay = 0, kFilterGate = 0, kLFO = 0;
    iHz = (midi).midicps;
    iVelocity = (velocity).clip(0, 1);
    aSource = (Pulse.ar(iHz, 0.49) * ((0 - 7.0)).dbamp);
    if((stage >= 2)) {
    aSecond = (SinOsc.ar((iHz * (2 ** (1.0 + (0 / 1200)))), 0 * 2pi) * ((0 - 22.0)).dbamp);
    aSource = (aSource + aSecond);
    kFilterGate = EnvGen.kr(Env([0, 1, 1], [0.005, 1], \lin));
    kFilterDecay = EnvGen.kr(Env([1, 1, 0.08, 0.000001], [0.005, 0.32, 0.25], \exp, releaseNode: 2), gate);
    kFilter = (kFilterGate * kFilterDecay);
    kLFO = (SinOsc.kr(0, 0 * 2pi) * 1);
    kCut = ((564.0 * (2 ** (((2.3 * kFilter) + ((0.7 * (midi - 60)) / 12)) + (0 * kLFO))))).clip(30, 18000);
    aSource = (((aSource * 1.4)).tanh / 1.4);
    aSource = MoogFF.ar(aSource, (kCut).clip(20, 18000), (0.16 * 4).clip(0, 3.95));
    };
    aAmpGate = EnvGen.ar(Env([0, 1, 1], [0.008, 1], \lin));
    aAmpDecay = EnvGen.ar(Env([1, 1, 0.15, 0.000001], [0.008, 2.12, 0.572], \exp, releaseNode: 2), gate);
    aAmp = (aAmpGate * aAmpDecay);
    aL = (((aSource * aAmp) * ((0 - 13.0)).dbamp) * (iVelocity ** 2.0));
    aR = aL;
    Out.ar(out, [aL, aR]);
        EnvGen.kr(Env.asr(0.0001, 1, 0.572), gate, doneAction: 2);
    }),
    SynthDef(\pgDuneReachEffects, { |in=0, out=0|
        var stage = ~soundStage;
        var outputScale = ~soundOutputScale;
        var input = In.ar(in, 2);
    var feedback = LocalIn.ar(2);
    var aChFbL = 0, aChFbR = 0, aChInL = 0, aChInR = 0, aChMid = 0, aChSide = 0, aChTimeL = 0, aChTimeR = 0;
    var aEndMid = 0, aEndSide = 0, aL = 0, aR = 0, aRoomInL = 0, aRoomInR = 0, aRoomL = 0, aRoomMid = 0;
    var aRoomPreL = 0, aRoomPreR = 0, aRoomR = 0, aRoomSide = 0, aTapL = 0, aTapR = 0, kCh = 0, room26 = 0;
    aL = input[0];
    aR = input[1];
    if((stage >= 3)) {
    aChFbL = feedback[0];
    aChFbR = feedback[1];
    aChInL = HPF.ar(aL, (180.0).clip(20, 18000));
    aChInR = HPF.ar(aR, (180.0).clip(20, 18000));
    kCh = (SinOsc.kr(0.44, 0 * 2pi) * 1);
    aChTimeL = K2A.ar((12 + (2.4000000000000004 * kCh)));
    aChTimeR = K2A.ar((12 - (2.4000000000000004 * kCh)));
    aTapL = DelayC.ar((aChInL + (aChFbL * 0)), 80 / 1000, (aChTimeL / 1000).clip(0.00002, 80 / 1000));
    aTapR = DelayC.ar((aChInR + (aChFbR * 0)), 80 / 1000, (aChTimeR / 1000).clip(0.00002, 80 / 1000));
    aChFbL = aTapL;
    aChFbR = aTapR;
    aL = ((aL * 0.8200000000000001) + (aTapL * 0.18));
    aR = ((aR * 0.8200000000000001) + (aTapR * 0.18));
    aChMid = ((aL + aR) * 0.5);
    aChSide = (((aL - aR) * 0.5) * 1.0);
    aL = (aChMid + aChSide);
    aR = (aChMid - aChSide);
    };
    if((stage >= 4)) {
    aRoomInL = aL;
    aRoomPreL = DelayN.ar(aRoomInL, 0.012, 0.012);
    aRoomInR = aR;
    aRoomPreR = DelayN.ar(aRoomInR, 0.012, 0.012);
    room26 = FreeVerb2.ar(aRoomPreL, aRoomPreR, 1, 0.579344, 0.71875);
    aRoomL = room26[0];
    aRoomR = room26[1];
    aRoomMid = ((aRoomL + aRoomR) * 0.5);
    aRoomSide = (((aRoomL - aRoomR) * 0.5) * 1);
    aL = ((aL * 0.83) + ((aRoomMid + aRoomSide) * 0.17));
    aR = ((aR * 0.83) + ((aRoomMid - aRoomSide) * 0.17));
    };
    if((stage >= 5)) {
    aEndMid = ((aL + aR) * 0.5);
    aEndSide = (((aL - aR) * 0.5) * 1.0);
    aL = ((aEndMid + aEndSide) * (3.6).dbamp);
    aL = LeakDC.ar(aL, 0.995);
    aR = ((aEndMid - aEndSide) * (3.6).dbamp);
    aR = LeakDC.ar(aR, 0.995);
    };
    LocalOut.ar([aChFbL, aChFbR].collect { |channel| channel + DC.ar(0) });
    Out.ar(out, [((aL * 1) * outputScale), ((aR * 1) * outputScale)]);
    })
];
~soundStop = {
    if(~cirrusGroup.notNil) { ~cirrusGroup.free; ~cirrusGroup = nil };
    if(~cirrusAudio.notNil) { ~cirrusAudio.free; ~cirrusAudio = nil };
    if(~cirrusMotion.notNil) { ~cirrusMotion.free; ~cirrusMotion = nil };
    if(~pgGroup.notNil) { ~pgGroup.free; ~pgGroup = nil };
    if(~pgAudio.notNil) { ~pgAudio.free; ~pgAudio = nil };
    if(~pgMotion.notNil) { ~pgMotion.free; ~pgMotion = nil };
};
~soundInstall = {
    s.waitForBoot {
        ~soundStop.();
        ~soundDefs.do { |definition| definition.add };
        s.sync;
        ~pgAudio = Bus.audio(s, 2);
        ~pgMotion = Bus.control(s, 1);
        ~pgGroup = Group.head(s);
        ~pgLastMidi = 60;
        Synth.head(~pgGroup, ~soundNames.motion, [\out, ~pgMotion]);
        ~pgVoices = Group.tail(~pgGroup);
        Synth.tail(~pgGroup, ~soundNames.effects, [\in, ~pgAudio]);
        "Dune Reach ready".postln;
    };
};
~soundNote = { |midi=60, velocity=0.8, hold=1|
    var note = Synth.head(~pgVoices, ~soundNames.voice, [
        \out, ~pgAudio, \midi, midi, \velocity, velocity.clip(0, 1),
        \startMidi, ~pgLastMidi
    ]);
    ~pgLastMidi = midi;
    SystemClock.sched(hold, { note.set(\gate, 0); nil });
    note;
};
if(~soundOffline != true) { ~soundInstall.() };
)