# Build Coral Isle in SuperCollider

A stock-unit SuperCollider interpretation of [the Ableton sound](/tutorials/coral-isle/) and its [Csound version](/tutorials/coral-isle/csound/). Each stage changes the source or its effect chain; oscillator, filter, modal and room algorithms differ across platforms.

[Starting settings](STARTING_STATE.md) · [Complete settings](ALL_PARAMETERS.md). The full runnable script ends this guide.

## Step 1 — Excite a decaying string mode bank

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. Feed a 1.5 ms shaped pulse with a quiet noise component into sixteen string modes. The strike position is 0.28 of string length and the pickup position 0.22. Each mode is weighted by the sine of both positions, so moving the strike changes which harmonics are suppressed. A small stiffness term bends upper partials away from perfect harmonic ratios. The fundamental T60 is 3.4 s and upper modes decay faster. This modal bank interprets Tension rather than implementing its plectrum and string solver.

| SuperCollider control | Value |
| --- | --- |
| Strike / pickup | 0.28 / 0.22 of length |
| Mode frequencies | f × n × sqrt(1 + 0.00008 × n²), below 11000 Hz |
| Decay | T60 / (1 + 0.08 × (n−1)^1.3) |
| Fundamental T60 | 3.4 s |
| Exciter lowpass | 4300 Hz |
| String scaling / instrument | 0.02 × (0.4 + 0.6 × velocity) / −10 dB |

<audio controls preload="none" aria-label="SuperCollider Coral Isle after step 1"><source src="audio/steps/step-01.webm" type="audio/webm"></audio>

[Sound after step 1 — WebM/Opus](audio/steps/step-01.webm)

## Step 2 — Blend body modes and soften the string

Set `~soundStage = 2` in the full script. Use broad body resonances at 97, 193 and 450 Hz with Q values 8, 12 and 18. Blend 12% of their weighted sum with the string and lowpass at 7300 Hz. The body colors the lower spectrum rather than supplying a sustained oscillator. Natural mode tails continue after the short excitation; the script holds their state for twice the fundamental T60. Body size, damping and pickup geometry are represented by these explicit choices, not a numerical conversion of all Tension macros.

| SuperCollider control | Value |
| --- | --- |
| Body modes | 97/193/450 Hz; Q 8/12/18 |
| Body weights / scale | 0.4/0.2/0.1 × 0.04 |
| Body mix | 12% |
| Lowpass | 7300 Hz |

The Q values describe the design targets: `Ringz` receives decay seconds computed as Q × ln(1000) / (π × frequency), not Q itself.

<audio controls preload="none" aria-label="SuperCollider Coral Isle after step 2"><source src="audio/steps/step-02.webm" type="audio/webm"></audio>

[Sound after step 2 — WebM/Opus](audio/steps/step-02.webm)

## Step 3 — Round the signal with saturation

Set `~soundStage = 3` in the full script. Use +1 dB drive with 30% shaped signal and -1 dB output trim. The smooth curve is `tanh(input × 3 × drive.dbamp) / 3`; the other portion stays clean. Louder peaks enter its curved region more strongly, adding harmonics and rounding the envelope. This interprets the source saturation curve rather than implementing its proprietary transfer function.

| SuperCollider control | Value |
| --- | --- |
| Drive / output | 1 / -1 dB |
| Shaped mix | 30% |
| Input DC removal | LeakDC, coefficient 0.995 |

<audio controls preload="none" aria-label="SuperCollider Coral Isle after step 3"><source src="audio/steps/step-03.webm" type="audio/webm"></audio>

[Sound after step 3 — WebM/Opus](audio/steps/step-03.webm)

## Step 4 — 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.29377 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.29377 |
| Damping | 0.71875 |
| Predelay | 12 ms |
| External room wet | 12% |

| SuperCollider control | Value |
| --- | --- |
| Room side multiplier | 1 |
| Room input cuts | Off |

<audio controls preload="none" aria-label="SuperCollider Coral Isle after step 4"><source src="audio/steps/step-04.webm" type="audio/webm"></audio>

[Sound after step 4 — WebM/Opus](audio/steps/step-04.webm)

## Step 5 — Set the final width and gain

Set `~soundStage = 5` in the full script. Use 23.1 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 | 23.1 dB |
| Width | 1 × side |
| Bass side cutoff | Off |
| DC removal | LeakDC, coefficient 0.995 |

<audio controls preload="none" aria-label="SuperCollider Coral Isle after step 5"><source src="audio/steps/step-05.webm" type="audio/webm"></audio>

[Sound after step 5 — WebM/Opus](audio/steps/step-05.webm)

## Downloads and settings

[Finished sound — WebM/Opus](audio/coral-isle.webm) · [Complete settings](ALL_PARAMETERS.md) · [Ableton version](/tutorials/coral-isle/) · [Csound version](/tutorials/coral-isle/csound/)

## Full SuperCollider script

The complete Coral Isle 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.

```supercollider
(
~soundStage = 5;
~soundOutputScale = 0.09732015;
~soundRelease = 6.8;
~soundNames = (motion: \pgCoralIsleMotion, voice: \pgCoralIsleVoice, effects: \pgCoralIsleEffects);
~pgString = { |excitation, hz, t60, position|
    Mix(Array.fill(16, { |i|
        var n = i + 1;
        var freq = hz * n * (1 + (0.00008 * n.squared)).sqrt;
        var decay = t60 / (1 + (0.08 * ((n - 1) ** 1.3)));
        var weight = sin(pi * n * position) * sin(pi * n * 0.22) / n;
        Ringz.ar(excitation, freq.clip(20, 11000), decay) * weight * (freq < 11000)
    }));
};
~soundDefs = [
    SynthDef(\pgCoralIsleMotion, { |out=0| Out.kr(out, DC.kr(0)) }),
    SynthDef(\pgCoralIsleVoice, { |out=0, midi=60, velocity=0.8, gate=1, startMidi=60|
        var stage = ~soundStage;
    var aBody = 0, aBody1 = 0, aBody2 = 0, aBody3 = 0, aExc = 0, aGate = 0, aL = 0, aNoise = 0;
    var aR = 0, aString = 0, iHz = 0, iVelocity = 0;
    iHz = (midi).midicps;
    iVelocity = (velocity).clip(0, 1);
    aGate = EnvGen.ar(Env([0, 1, 0, 0], [0.0003, 0.0012, 1], \lin));
    aNoise = WhiteNoise.ar(1);
    aExc = OnePole.ar((aGate * (0.8 + (0.2 * aNoise))), (-2pi * (4300.0).clip(20, 18000) / SampleRate.ir).exp);
    aString = ~pgString.(aExc, iHz, 3.4000000000000004, 0.28);
    aString = (((aString * 0.02) * (0.4 + (0.6 * iVelocity))) * ((0 - 10)).dbamp);
    aL = aString;
    aR = aString;
    if((stage >= 2)) {
    aBody1 = Ringz.ar(aString, (97).clip(20, 11000), ((8 * 1000.log) / (pi * 97)).clip(0.0001, 60));
    aBody2 = Ringz.ar(aString, (193).clip(20, 11000), ((12 * 1000.log) / (pi * 193)).clip(0.0001, 60));
    aBody3 = Ringz.ar(aString, (450).clip(20, 11000), ((18 * 1000.log) / (pi * 450)).clip(0.0001, 60));
    aBody = ((((aBody1 * 0.4) + (aBody2 * 0.2)) + (aBody3 * 0.1)) * 0.04);
    aL = ((aString * 0.88) + (aBody * 0.12));
    aL = LPF.ar(aL, (7300.0).clip(20, 18000));
    aR = aL;
    };
    Out.ar(out, [aL, aR]);
        EnvGen.kr(Env.asr(0.0001, 1, 6.8), gate, doneAction: 2);
    }),
    SynthDef(\pgCoralIsleEffects, { |in=0, out=0|
        var stage = ~soundStage;
        var outputScale = ~soundOutputScale;
        var input = In.ar(in, 2);
    var aCleanL = 0, aCleanR = 0, aEndMid = 0, aEndSide = 0, aL = 0, aR = 0, aRoomInL = 0, aRoomInR = 0;
    var aRoomL = 0, aRoomMid = 0, aRoomPreL = 0, aRoomPreR = 0, aRoomR = 0, aRoomSide = 0, aShapeL = 0, aShapeR = 0;
    var room15 = 0;
    aL = input[0];
    aR = input[1];
    if((stage >= 3)) {
    aCleanL = LeakDC.ar(aL, 0.995);
    aShapeL = ((((aCleanL * 3) * (1.0).dbamp)).tanh / 3);
    aL = (((aCleanL * 0.7) + (aShapeL * 0.3)) * ((0 - 1.0)).dbamp);
    aCleanR = LeakDC.ar(aR, 0.995);
    aShapeR = ((((aCleanR * 3) * (1.0).dbamp)).tanh / 3);
    aR = (((aCleanR * 0.7) + (aShapeR * 0.3)) * ((0 - 1.0)).dbamp);
    };
    if((stage >= 4)) {
    aRoomInL = aL;
    aRoomPreL = DelayN.ar(aRoomInL, 0.012, 0.012);
    aRoomInR = aR;
    aRoomPreR = DelayN.ar(aRoomInR, 0.012, 0.012);
    room15 = FreeVerb2.ar(aRoomPreL, aRoomPreR, 1, 0.29377, 0.71875);
    aRoomL = room15[0];
    aRoomR = room15[1];
    aRoomMid = ((aRoomL + aRoomR) * 0.5);
    aRoomSide = (((aRoomL - aRoomR) * 0.5) * 1);
    aL = ((aL * 0.88) + ((aRoomMid + aRoomSide) * 0.12));
    aR = ((aR * 0.88) + ((aRoomMid - aRoomSide) * 0.12));
    };
    if((stage >= 5)) {
    aEndMid = ((aL + aR) * 0.5);
    aEndSide = (((aL - aR) * 0.5) * 1.0);
    aL = ((aEndMid + aEndSide) * (23.1).dbamp);
    aL = LeakDC.ar(aL, 0.995);
    aR = ((aEndMid - aEndSide) * (23.1).dbamp);
    aR = LeakDC.ar(aR, 0.995);
    };
    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]);
        "Coral Isle 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.() };
)
```

[Read on playgrid.cc](https://playgrid.cc/tutorials/coral-isle/supercollider/)
