DEV Community: Anup Jayant Dharangutti

Procedural Game and Application Audio in .NET

Anup Jayant Dharangutti — Fri, 18 Sep 2026 11:48:59 +0000

What if your application generated sound from state instead of maintaining a WAV file for every possible variation?

Games and interactive applications are full of events.

A player collects an item.

A mission completes.

Health drops.

A warning appears.

A build succeeds.

A device enters an error state.

A message arrives.

The traditional architecture is straightforward:

Event
  ↓
Audio Asset
  ↓
Play

And for many products, that's exactly the right solution.

But sometimes sound isn't static.

Sometimes it depends on runtime state.

In those cases, a growing library of audio files can become increasingly difficult to maintain.

Instead of:

warning-1.wav
warning-2.wav
warning-3.wav
warning-4.wav

what if the application could derive the cue from the state itself?

That's where SoundScript becomes interesting.

Application State
        ↓
   Musical Rules
        ↓
   SoundScript
        ↓
    WAV / MIDI

Rather than selecting every sound from an asset library, your application generates controlled musical behaviour from data.

Let's build one.

Install SoundScript

SoundScript 13 targets .NET 10.

dotnet add package SoundScript --version 13.0.0

We'll start with a small set of application events.

Define Event Cues

Imagine a game or desktop application supports these events:

Collect
Achievement
Warning
Failure

Create a simple model:

record AudioCue(
    int Tempo,
    string Dynamic,
    string Motif);

Now define your musical rules:

var cues =
    new Dictionary<string, AudioCue>
    {
        ["collect"] =
            new(
                132,
                "mf",
                "C4 e E4 e G4 q"),

        ["achievement"] =
            new(
                120,
                "f",
                "C4 e E4 e G4 e C5 q"),

        ["warning"] =
            new(
                104,
                "f",
                "A3 e A3 e E4 q A3 e"),

        ["failure"] =
            new(
                72,
                "ff",
                "C3 e C3 e G2 q C3 e")
    };

Notice what the application owns:

Tempo
Dynamics
Musical motifs

Not:

Audio samples
DSP code
MIDI event streams
Waveform generation

The application describes intent.

Turn an Event into Audio

Choose an event:

var cue =
    cues["achievement"];

Build a SoundScript program:

var source = $"""
    tempo {cue.Tempo}

    track eventCue {{
        instrument piano

        {cue.Dynamic}

        {cue.Motif}
    }}
    """;

Render it:

using SoundScript;

var wav =
    SoundScriptEngine
        .Compile(source)
        .RenderWave();

File.WriteAllBytes(
    "achievement.wav",
    wav);

The entire pipeline becomes:

Achievement Event
        ↓
 Lookup Musical Rule
        ↓
    SoundScript
        ↓
        WAV

Why Not Just Use WAV Files?

A fair question.

If your product genuinely has four final sounds:

collect.wav
achievement.wav
warning.wav
failure.wav

then static assets are probably simpler.

Procedural generation becomes more compelling when runtime state influences the cue.

For example:

Warning
    +
Severity 1

may not need to sound identical to:

Warning
    +
Severity 4

Instead of storing:

warning-1.wav
warning-2.wav
warning-3.wav
warning-4.wav

you can derive variation from application state.

Let Severity Control Dynamics

Suppose severity ranges from 1 to 4.

Map it into musical dynamics:

var dynamic =
    severity switch
    {
        1 => "mp",
        2 => "mf",
        3 => "f",
        _ => "ff"
    };

Conceptually:

Severity 1 → mp
Severity 2 → mf
Severity 3 → f
Severity 4 → ff

The business meaning remains entirely inside the application.

SoundScript simply renders the resulting musical behaviour.

Let Progression Influence Tempo

Games often evolve over time.

A simple rule:

var tempo =
    80 + level * 4;

Produces:

Level 1  → Tempo 84
Level 5  → Tempo 100
Level 10 → Tempo 120

Your cue can evolve naturally without requiring dozens of manually authored audio assets.

Let State Choose the Musical Motif

You can also map application state directly into motifs.

var motif =
    status switch
    {
        "healthy" =>
            "C4 e E4 e G4 q",

        "degraded" =>
            "A3 e E4 e A3 q",

        "critical" =>
            "C3 e C3 e G2 q",

        _ =>
            "C4 q"
    };

Conceptually:

Healthy
    ↓
Bright Motif

Degraded
    ↓
Warning Motif

Critical
    ↓
Failure Motif

This keeps the relationship between state and sound explicit.

Combine Multiple Pieces of State

Most real applications have more than one variable.

Imagine:

record RuntimeState(
    string Status,
    int Severity,
    int Level);

Now derive each musical property independently.

var tempo =
    80 + state.Level * 4;

var dynamic =
    state.Severity switch
    {
        1 => "mp",
        2 => "mf",
        3 => "f",
        _ => "ff"
    };

var motif =
    state.Status switch
    {
        "healthy" =>
            "C4 e E4 e G4 q",

        "warning" =>
            "A3 e A3 e E4 q",

        "critical" =>
            "C3 e C3 e G2 q",

        _ =>
            "C4 q"
    };

Generate the final source:

var source = $"""
    tempo {tempo}

    track stateCue {{
        instrument piano

        {dynamic}
        {motif}
    }}
    """;

Render:

var wav =
    SoundScriptEngine
        .Compile(source)
        .RenderWave();

One event can now produce meaningful variation from multiple dimensions of state.

Procedural Audio Without DSP

The term procedural audio often makes developers think about:

Oscillators
Filters
Envelopes
Mixers
Modulation
Sample buffers

That's one kind of procedural audio.

SoundScript operates at a higher level.

Instead of thinking in samples, you're thinking in:

Tempo
Notes
Dynamics
Instruments
Motifs
Musical phrases

The question becomes:

What should this state sound like?

rather than:

How do I generate every sample?

Static vs Procedural Architectures

Static Assets

Event
  ↓
Asset Key
  ↓
WAV
  ↓
Play

Advantages

Simple
Predictable
Easy to preview
Production-friendly

Trade-off

More variations typically require more assets.

Procedural Audio

Event + State
       ↓
      Rules
       ↓
 Musical Source
       ↓
     Render
       ↓
      Play

Advantages

State-driven variation
Versionable rules
Reproducible output
Fewer asset variants

Trade-off

More application logic

Neither approach is universally superior.

The right choice depends on the problem.

The Best Architecture Is Often Hybrid

Most games shouldn't generate everything.

A practical hybrid might use static assets for:

Main themes
Voice acting
Hero moments
Cinematics
Signature character sounds

And procedural generation for:

Status cues
Notifications
Temporary UI sounds
Alerts
Monitoring events
Prototype content

Hand Crafted Audio
         +
 Procedural Utility Audio

The two approaches complement each other well.

Cache Generated Audio

If the same state appears repeatedly, avoid rendering identical output over and over.

Build a cache key:

var key =
    $"{eventName}:{severity}:{level}";

Check the cache:

if (cache.TryGetValue(
        key,
        out var existing))
{
    return existing;
}

Otherwise render:

var wav =
    SoundScriptEngine
        .Compile(source)
        .RenderWave();

cache[key] = wav;

return wav;

The flow becomes:

Event
  ↓
Build Key
  ↓
Cache?
 ↙     ↘
Hit    Miss
 ↓       ↓
Play   Render
          ↓
        Cache
          ↓
         Play

Deterministic generation makes caching extremely natural.

Procedural Doesn't Have to Mean Runtime

Another pattern is build-time generation.

Imagine your game supports:

3 Statuses
×
4 Severity Levels
×
3 Environments

That's:

36 Variations

A build step could generate:

success-1-dev.wav
success-2-dev.wav
success-3-dev.wav

warning-1-prod.wav
warning-2-prod.wav

failure-4-prod.wav
...

Runtime remains:

State
  ↓
Lookup
  ↓
Play

But the assets were generated from version-controlled rules.

This hybrid approach is often very attractive.

Example: Health Warning System

Imagine a player currently has:

var health = 24;

Map health into severity:

var severity =
    health switch
    {
        > 70 => 1,
        > 40 => 2,
        > 20 => 3,
        _ => 4
    };

Then dynamics:

var dynamic =
    severity switch
    {
        1 => "mp",
        2 => "mf",
        3 => "f",
        _ => "ff"
    };

Result:

Health 90 → Quiet Cue
Health 50 → Medium Cue
Health 24 → Strong Cue
Health 8  → Very Strong Cue

The gameplay state now influences sound directly.

Example: Achievement Rarity

Suppose achievements have rarity levels:

Common
Rare
Epic
Legendary

Map them into different motifs:

var motif =
    rarity switch
    {
        "common" =>
            "C4 e E4 q",

        "rare" =>
            "C4 e E4 e G4 q",

        "epic" =>
            "C4 e E4 e G4 e C5 q",

        "legendary" =>
            "C4 e E4 e G4 e C5 e E5 h",

        _ =>
            "C4 q"
    };

Now the musical phrase itself communicates rarity.

Rarity
   ↓
Known Rule
   ↓
Known Musical Behaviour

No AI required.

No randomness required.

Example: Monitoring Applications

The same concept works outside games.

Suppose a monitoring system tracks:

Healthy
Degraded
Critical

Map them into motifs:

var motif =
    status switch
    {
        "healthy" =>
            "C4 e E4 e G4 q",

        "degraded" =>
            "A3 e A3 e E4 q",

        "critical" =>
            "C3 e C3 e G2 q",

        _ =>
            "C4 q"
    };

Now system health can have an auditory representation.

Not as a replacement for dashboards.

As an additional information channel.

Procedural Rules Are Reviewable

Suppose you modify a warning cue:

- A3 e A3 e E4 q
+ A3 e C4 e E4 e A4 q

That's reviewable in Git.

Compare that to:

warning.wav changed

where the most detailed review may simply be:

binary file modified

Developer-owned audio behaviour benefits from being represented as text.

Generated Audio Can Be Tested

Deterministic generation enables automated testing.

var first =
    RenderEventCue(
        "warning",
        severity: 3,
        level: 8);

var second =
    RenderEventCue(
        "warning",
        severity: 3,
        level: 8);

Console.WriteLine(
    first.AsSpan()
         .SequenceEqual(second));

Or generate a hash:

using System.Security.Cryptography;

var hash =
    Convert.ToHexString(
        SHA256.HashData(first));

Console.WriteLine(hash);

Your audio behaviour becomes part of your testable system.

A Reusable Renderer

You can wrap the entire approach into a helper:

using SoundScript;

static byte[] RenderEventCue(
    string eventName,
    int severity,
    int level)
{
    var dynamic =
        severity switch
        {
            1 => "mp",
            2 => "mf",
            3 => "f",
            _ => "ff"
        };

    var motif =
        eventName switch
        {
            "collect" =>
                "C4 e E4 e G4 q",

            "achievement" =>
                "C4 e E4 e G4 e C5 q",

            "warning" =>
                "A3 e A3 e E4 q A3 e",

            "failure" =>
                "C3 e C3 e G2 q C3 e",

            _ =>
                "C4 q"
        };

    var tempo =
        80 + level * 4;

    var source = $"""
        tempo {tempo}

        track eventCue {{
            instrument piano

            {dynamic}
            {motif}
        }}
        """;

    return SoundScriptEngine
        .Compile(source)
        .RenderWave();
}

Usage:

var wav =
    RenderEventCue(
        "warning",
        severity: 3,
        level: 8);

File.WriteAllBytes(
    "warning.wav",
    wav);

The application interface remains simple and expressive.

What the Application Owns

The application owns:

Event semantics
State
Severity rules
Progression systems
Cache strategy
Playback decisions

SoundScript owns:

Musical representation
Compilation
Rendering
WAV generation
MIDI generation

That's a healthy separation.

Where Procedural Audio Fits Best

🎮 Game Prototypes

Generate useful audio before final sound design exists.

🔔 Application Notifications

Create state-driven event cues.

🚦 Monitoring Systems

Sonify changing system health.

♿ Accessibility

Provide additional non-visual feedback.

🏭 Industrial Applications

Represent process and machine states.

🧪 Automated Testing

Generate deterministic audio fixtures.

🎓 Education

Demonstrate state-to-music mappings.

🛠 Developer Tooling

Generate build and status cues programmatically.

When Static Assets Are Still Better

Static assets remain the right choice when you need:

Professional sound design
Recorded instruments
Voice acting
Branded audio
Cinematic sequences
Ambient environments
Mastered production quality

Procedural audio doesn't replace professionally authored media.

It complements it.

One Simple Rule

Ask a single question:

Does the sound meaningfully depend on application state?

If the answer is:

No

Use a static asset.

If the answer is:

Yes

Consider procedural generation.

That's usually the right architectural test.

The Bigger Idea

Applications already generate many outputs from state.

State
  ↓
UI

State
  ↓
Notification

State
  ↓
API Response

State
  ↓
Report

SoundScript adds another possibility:

State
  ↓
Musical Behaviour
  ↓
Audio

That's the core idea behind procedural application audio.

Try It Yourself

Install SoundScript:

dotnet add package SoundScript --version 13.0.0

Start with:

var source = """
    tempo 120

    track eventCue {
        instrument piano

        mf

        C4 e
        E4 e
        G4 q
    }
    """;

Render it:

var wav =
    SoundScriptEngine
        .Compile(source)
        .RenderWave();

File.WriteAllBytes(
    "cue.wav",
    wav);

Then make the source depend on:

Event
Severity
Level
Status

Change one variable at a time and observe how the output evolves.

The workflow becomes:

Application State
        ↓
Derive Musical Intent
        ↓
Compile
        ↓
Render
        ↓
Cache or Store
        ↓
Play

That's procedural audio from a developer's perspective.

Try SoundScript

dotnet add package SoundScript --version 13.0.0

Resources

🌐 Website: https://soundscript.net/
📦 NuGet: https://www.nuget.org/packages/SoundScript
💻 GitHub: https://github.com/dharangutti/sound-script
📚 Documentation: https://soundscript.net/doc.html?p=documentation.md
🚀 V13 Release: https://github.com/dharangutti/sound-script/releases/tag/v13.0.0

SoundScript Developer Series

Generate Background Music from JSON in .NET

In This Series

Generate MIDI and WAV in a Few Lines of C#
Deterministic Audio for Automated Testing in .NET
Text-to-Music with SoundScript: Deterministic Composition Instead of Prompting
Generate Background Music from JSON in .NET
Procedural Game and Application Audio in .NET

SoundScript

Write audio and media like code.

📧 info@dharangutti.in

🌐 https://www.dharangutti.in/

Generate Background Music from JSON in .NET

Anup Jayant Dharangutti — Fri, 18 Sep 2026 11:48:05 +0000

What if application data could drive sound without your application owning an entire audio engine?

Modern applications already use JSON to describe behaviour.

Configuration
User preferences
Application state
Notifications
Workflow status
Environment settings
Feature flags

That data typically controls things like:

JSON
  ↓
UI

JSON
  ↓
Feature Behaviour

JSON
  ↓
API Configuration

JSON
  ↓
Workflow Logic

But JSON can also drive audio.

With SoundScript, a .NET application can transform ordinary structured data into musical intent and render deterministic WAV or MIDI output.

The key idea is that JSON is not SoundScript's language.

Your application owns the JSON schema.

Your application decides what the data means.

SoundScript simply performs the rendering.

JSON
  ↓
Application Mapping
  ↓
SoundScript Source
  ↓
Compile
  ↓
WAV / MIDI

That separation turns out to be surprisingly useful.

Business data remains business data.

Audio remains programmable.

Let's build it.

Install SoundScript

SoundScript 13 targets .NET 10.

dotnet add package SoundScript --version 13.0.0

We'll also use the JSON functionality built into .NET.

Start with a Simple Configuration

Imagine an application has a configuration file like this:

{
  "name": "checkout-success",
  "tempo": 120,
  "dynamic": "mf",
  "notes": "C4 e E4 e G4 e C5 q"
}

Create a matching model:

record AudioCue(
    string Name,
    int Tempo,
    string Dynamic,
    string Notes);

Load the JSON:

using System.Text.Json;

var json =
    File.ReadAllText("cue.json");

var cue =
    JsonSerializer.Deserialize<AudioCue>(
        json)
    ?? throw new InvalidOperationException(
        "Invalid audio configuration.");

At this stage there's nothing audio-specific happening.

The application simply has structured state.

Map JSON into SoundScript

Now transform that state into musical intent.

var source = $"""
    tempo {cue.Tempo}

    track cue {{
        instrument piano

        {cue.Dynamic}

        {cue.Notes}
    }}
    """;

Compile and render:

using SoundScript;

var compilation =
    SoundScriptEngine.Compile(source);

var wav =
    compilation.RenderWave();

var midi =
    compilation.RenderMidi();

File.WriteAllBytes(
    $"{cue.Name}.wav",
    wav);

File.WriteAllBytes(
    $"{cue.Name}.mid",
    midi);

That's the entire pipeline.

cue.json
    ↓
Deserialize
    ↓
Application Model
    ↓
Map to SoundScript
    ↓
Compile
    ↓
checkout-success.wav
checkout-success.mid

Why Not Just Store a WAV File?

A reasonable question.

For a single fixed cue:

checkout-success.wav

is often the best solution.

Static assets are:

Easy to preview
Professionally designed
Simple to deploy
Simple to maintain

You shouldn't replace static audio just because dynamic generation is possible.

The value appears when application state influences the sound.

Example: Severity-Driven Audio

Suppose the application receives:

{
  "state": "warning",
  "severity": 3
}

Instead of exposing raw audio controls, define a simple business model:

record StatusCue(
    string State,
    int Severity);

Map severity into known dynamics:

var dynamic =
    cue.Severity switch
    {
        1 => "mp",
        2 => "mf",
        3 => "f",
        _ => "ff"
    };

Map state into known musical motifs:

var motif =
    cue.State switch
    {
        "success" =>
            "C4 e E4 e G4 e C5 q",

        "warning" =>
            "A3 e A3 e E4 q A3 e",

        "failure" =>
            "C3 e C3 e G2 q C3 e",

        _ =>
            "C4 q"
    };

Create SoundScript:

var source = $"""
    tempo 110

    track status {{
        instrument piano

        {dynamic}
        {motif}
    }}
    """;

And render:

var wav =
    SoundScriptEngine
        .Compile(source)
        .RenderWave();

Notice the separation of responsibilities:

State + Severity
         ↓
Application Rules
         ↓
Musical Intent
         ↓
SoundScript
         ↓
Audio

Keep Business Logic Outside the Audio Engine

This is an important architectural boundary.

You probably don't want SoundScript deciding:

Severity 4 = Emergency

That's an application concern.

Likewise, you probably don't want your business configuration describing:

MIDI Channel 1
Velocity 112
Tick Position 480

That's audio implementation detail.

A cleaner architecture is:

Business State
      ↓
Application Rules
      ↓
Musical Intent
      ↓
SoundScript
      ↓
Audio

Each layer has a single responsibility.

Avoid Passing Arbitrary Source from JSON

A tempting approach is:

{
  "source": "tempo 120 track x { ... }"
}

followed by:

SoundScriptEngine.Compile(
    config.Source);

For trusted developer-authored configuration, that's perfectly valid.

For user data or external input, a better pattern is:

{
  "state": "warning",
  "intensity": 2
}

Then map it explicitly:

Known Input
      ↓
Validation
      ↓
Application Rules
      ↓
Known Musical Structures

Rather than:

Arbitrary String
        ↓
Compiler

The same principle applies to many configurable systems.

A More Realistic Example

Imagine a deployment monitoring system producing:

{
  "event": "deployment",
  "result": "failed",
  "severity": 4,
  "environment": "production"
}

Create a model:

record DeploymentEvent(
    string Event,
    string Result,
    int Severity,
    string Environment);

Now define rules.

Tempo

var tempo =
    data.Environment switch
    {
        "production" => 116,
        "staging" => 104,
        _ => 96
    };

Dynamic

var dynamic =
    data.Severity switch
    {
        <= 1 => "mp",
        2 => "mf",
        3 => "f",
        _ => "ff"
    };

Motif

var motif =
    data.Result switch
    {
        "success" =>
            "C4 e E4 e G4 e C5 q",

        "failed" =>
            "C3 e C3 e G2 q C3 e",

        _ =>
            "C4 q"
    };

Assemble the cue:

var source = $"""
    tempo {tempo}

    track deployment {{
        instrument piano

        {dynamic}
        {motif}
    }}
    """;

The same deployment state always produces the same intended musical behaviour.

That's one of the biggest advantages of deterministic audio.

JSON Is Control Data, Not Music

Notice the difference between these two representations.

Application state:

{
  "result": "failed",
  "severity": 4
}

Musical intent:

tempo 116

track deployment {
    instrument piano
    ff

    C3 e
    C3 e
    G2 q
    C3 e
}

They serve different purposes.

Trying to make them identical often creates unnecessary coupling.

Keeping them separate tends to produce cleaner designs.

Why Not Use an AI Music API?

Let's compare the goals.

Imagine sending:

{
  "state": "warning",
  "severity": 3
}

to a generative music system using a prompt like:

Create a short urgent notification sound for severity level 3.

That can work very well if you want creative variation.

But application audio often requires different guarantees.

You may want:

Severity 3
      ↓
Same Rules
      ↓
Same Output

You may want to:

Test it
Cache it
Hash it
Version it
Reproduce it

Deterministic generation is often a better fit for those requirements.

Comparing Audio Architectures

Static Assets

State
  ↓
Lookup
  ↓
Existing WAV

Advantages

Simple
Fast
Professional audio quality

Trade-off

Every variation usually requires another asset.

Generative Music Service

State
  ↓
Prompt
  ↓
Model
  ↓
Generated Audio

Advantages

Creative
Rich output
Large stylistic range

Trade-off

Probabilistic behaviour
External dependencies
Different reproducibility model

DSP / Custom Synthesis

State
  ↓
DSP Code
  ↓
Oscillators
Envelopes
Mixers
  ↓
PCM Audio

Advantages

Maximum control

Trade-off

Significant audio-engine complexity

SoundScript

State
  ↓
Application Rules
  ↓
Musical Intent
  ↓
SoundScript
  ↓
WAV / MIDI

This occupies a useful middle ground.

More dynamic than static assets
Higher level than DSP
More deterministic than prompt generation

User-Configurable Notification Profiles

Imagine users can select:

{
  "notificationStyle": "gentle",
  "speed": "normal"
}

Your application maps:

gentle
   ↓
piano
mp

and:

normal
   ↓
tempo 100

Another profile might be:

{
  "notificationStyle": "urgent",
  "speed": "fast"
}

Mapping to:

urgent
  ↓
stronger dynamic
different motif

fast
  ↓
tempo 132

Notice that you're exposing meaningful product concepts, not audio-engine internals.

That's generally easier for both developers and users.

Game State as Audio

Imagine:

{
  "health": 24,
  "danger": true,
  "level": 7
}

Application rules derive:

danger = true
      ↓
warning motif

health < 30
      ↓
stronger dynamic

level = 7
      ↓
tempo adjustment

Result:

Game State
     ↓
Application Rules
     ↓
Musical State
     ↓
Audio

This pattern is particularly useful during prototyping when sound design is still evolving.

Cache Repeated States

Not every cue needs to be rendered repeatedly.

Generate a cache key:

var key =
    $"{state}:{severity}:{tempo}";

Then:

if (cache.TryGetValue(
        key,
        out var existing))
{
    return existing;
}

Otherwise:

var wav =
    SoundScriptEngine
        .Compile(source)
        .RenderWave();

cache[key] = wav;

return wav;

The architecture becomes:

Application State
         ↓
      Key
    ↙     ↘
 Hit     Miss
  ↓        ↓
Reuse   Render
           ↓
        Cache

A simple optimisation with substantial benefits.

Generate Assets at Build Time

Dynamic audio doesn't have to mean runtime rendering.

Suppose you support:

3 States
× 4 Severity Levels

That's only:

12 Outputs

A build pipeline could generate:

success-1.wav
success-2.wav
success-3.wav
success-4.wav

warning-1.wav
warning-2.wav
warning-3.wav
warning-4.wav

failure-1.wav
failure-2.wav
failure-3.wav
failure-4.wav

At runtime, the application simply loads files.

You keep deterministic generation while avoiding runtime rendering entirely.

This hybrid model is often very practical.

Audio Mappings Can Be Tested

Because generation is deterministic, it can participate in automated testing.

var first =
    BuildCue(config);

var second =
    BuildCue(config);

Assert.True(
    first.AsSpan()
         .SequenceEqual(second));

Or use hashes:

using System.Security.Cryptography;

var hash =
    Convert.ToHexString(
        SHA256.HashData(first));

Console.WriteLine(hash);

Your configuration-to-sound rules become testable software.

A Simple Helper

You can encapsulate the entire workflow:

using SoundScript;

static byte[] RenderCue(
    string state,
    int severity)
{
    var dynamic =
        severity switch
        {
            1 => "mp",
            2 => "mf",
            3 => "f",
            _ => "ff"
        };

    var motif =
        state switch
        {
            "success" =>
                "C4 e E4 e G4 e C5 q",

            "warning" =>
                "A3 e A3 e E4 q A3 e",

            "failure" =>
                "C3 e C3 e G2 q C3 e",

            _ =>
                "C4 q"
        };

    var source = $"""
        tempo 110

        track cue {{
            instrument piano

            {dynamic}
            {motif}
        }}
        """;

    return SoundScriptEngine
        .Compile(source)
        .RenderWave();
}

Usage:

var wav =
    RenderCue(
        "warning",
        3);

File.WriteAllBytes(
    "warning.wav",
    wav);

Your application stays focused on:

State
Severity

rather than audio implementation details.

Where This Approach Fits

🔔 Application Notifications

Generate controlled cues from application events.

🎮 Games

Derive audio behaviour from game state.

🚦 Monitoring

Map system status into repeatable cues.

♿ Accessibility Experiments

Create structured non-visual feedback.

🏭 Industrial Applications

Represent machine and process states.

🎓 Education

Demonstrate how structured data can drive music.

🔄 CI/CD

Turn build and deployment status into deterministic audio.

🧪 Automated Testing

Generate reproducible audio fixtures.

When Not to Use It

Don't adopt this architecture simply because your application already uses JSON.

If the requirement is:

Play one professionally designed notification sound.

Then:

notification.wav

may be the ideal solution.

Dynamic generation becomes valuable when audio meaningfully depends on application state.

That's the real decision point.

The Bigger Idea

Modern software already transforms data into many outputs.

JSON
  ↓
UI

JSON
  ↓
HTML

JSON
  ↓
API Behaviour

JSON
  ↓
Workflow Execution

Programmable audio adds another possibility:

JSON
  ↓
Application Rules
  ↓
Musical Intent
  ↓
Audio

The important part isn't the JSON.

The important part is that sound becomes another output of application logic.

Try It Yourself

Create:

{
  "name": "success",
  "tempo": 120,
  "dynamic": "mf",
  "notes": "C4 e E4 e G4 e C5 q"
}

Map it to SoundScript:

var source = $"""
    tempo {cue.Tempo}

    track cue {{
        instrument piano

        {cue.Dynamic}
        {cue.Notes}
    }}
    """;

Render it:

var wav =
    SoundScriptEngine
        .Compile(source)
        .RenderWave();

File.WriteAllBytes(
    $"{cue.Name}.wav",
    wav);

Then experiment.

Change:

"tempo": 120

to:

"tempo": 80

Or:

"dynamic": "mf"

to:

"dynamic": "ff"

Render again and compare the result.

The workflow is straightforward:

Configure
     ↓
Map
     ↓
Compile
     ↓
Render
     ↓
Listen

Try SoundScript

dotnet add package SoundScript --version 13.0.0

Resources

🌐 Website: https://soundscript.net/
📦 NuGet: https://www.nuget.org/packages/SoundScript
💻 GitHub: https://github.com/dharangutti/sound-script
📚 Documentation: https://soundscript.net/doc.html?p=documentation.md
🚀 V13 Release: https://github.com/dharangutti/sound-script/releases/tag/v13.0.0

SoundScript Developer Series

Text-to-Music with SoundScript: Deterministic Composition Instead of Prompting

Coming Next

Procedural Game and Application Audio in .NET

We'll move from configuration-driven cues to event-driven procedural audio and explore when generated sound makes more sense than maintaining large collections of static assets.

SoundScript

Write audio and media like code.

📧 info@dharangutti.in

🌐 https://www.dharangutti.in/

Text-to-Music with SoundScript: Deterministic Composition Instead of Prompting

Anup Jayant Dharangutti — Fri, 18 Sep 2026 11:47:38 +0000

Generated music does not have to mean unpredictable music.

When developers hear text-to-music today, they often think of generative AI.

The workflow is familiar:

Prompt
   ↓
AI Model
   ↓
Music

It's a powerful approach when your goal is creativity, experimentation, or stylistic exploration.

But what if your requirements are different?

What if:

The same input must produce the same output
Results must be reproducible in CI/CD
Generated music must be testable
Output should be inspectable and versionable
Media generation should behave like software

That's the problem SoundScript's text composition engine is designed to solve.

Instead of interpreting prompts probabilistically, SoundScript applies a deterministic transformation pipeline.

Plain Text
     ↓
Syllables
     ↓
Phonemes
     ↓
Musical Gestures
     ↓
Musical Program
     ↓
MIDI

Same input.

Same rules.

Same output.

Every time.

Generated Music vs Deterministic Music

Most AI music systems optimise for creative interpretation.

You might ask for:

"An emotional piano piece about space exploration."

The model then decides how to interpret that request.

Two runs may produce two different results.

That's often exactly what you want.

SoundScript asks a different question:

Can text be transformed into musical structure using explicit, repeatable rules?

This distinction is important.

AI Generation

Prompt
   ↓
Generative Model
   ↓
Creative Interpretation
   ↓
Music

SoundScript Composition

Text
  ↓
Deterministic Rules
  ↓
Musical Structure
  ↓
MIDI

Both are useful.

They solve different problems.

Install SoundScript

SoundScript 13 targets .NET 10.

dotnet add package SoundScript --version 13.0.0

SoundScript includes a text composition subsystem capable of transforming ordinary text into musical material.

A minimal example looks like this:

using SoundScript.Compose;
using SoundScript.Midi;

var program =
    PhonemeComposer.ComposeProgram(
        "Twinkle twinkle little star");

using var stream =
    new MemoryStream();

MidiGenerator.Write(
    program,
    stream);

File.WriteAllBytes(
    "twinkle.mid",
    stream.ToArray());

The result is a standard MIDI file generated directly from text.

No hosted AI service.

No prompts.

No random seeds.

No unpredictable interpretation.

Just a deterministic transformation pipeline.

What Happens to the Text?

Consider this input:

Twinkle twinkle little star

Before music appears, SoundScript processes the text through several stages.

Stage 1: Syllable Analysis

Conceptually:

Twinkle twinkle little star
         ↓
 Twin
 kle
 twin
 kle
 lit
 tle
 star

The text is broken into manageable linguistic units.

Stage 2: Phoneme Analysis

Those units are further analysed into phoneme-like components.

For example:

star
  ↓

s
t
aa
r

This stage focuses on how words sound rather than how they're spelled.

Stage 3: Musical Gestures

Phoneme categories are mapped to musical behaviours.

Conceptually:

Phoneme
    ↓
Gesture

Possible gesture categories include:

Staccato
Legato
Accent
Swell
Fade

These categories influence musical expression.

Stage 4: Musical Structure

The generated gestures become actual musical events.

Word
  ↓
Syllable
  ↓
Phoneme
  ↓
Gesture
  ↓
Pitch + Rhythm + Articulation
  ↓
Phrase

Those phrases are assembled into a complete musical program ready for MIDI generation.

Why Determinism Matters

Suppose your application generates media.

Many software systems require reproducibility.

Input A
   ↓
Output A

Run again:

Input A
   ↓
Output A

And again:

Input A
   ↓
Output A

The same result every time.

That property is valuable in:

🧪 Automated testing
🔄 CI/CD
🎓 Educational software
📊 Data sonification
🧬 Research
🎮 Procedural content generation
📦 Build-time asset generation
📚 Reproducible demonstrations

For software engineers, repeatability is often more valuable than creativity.

Verify It in Code

Let's turn composition into a reusable function.

using SoundScript.Compose;
using SoundScript.Midi;

static byte[] Compose(
    string text)
{
    var program =
        PhonemeComposer.ComposeProgram(
            text);

    using var stream =
        new MemoryStream();

    MidiGenerator.Write(
        program,
        stream);

    return stream.ToArray();
}

Generate output twice:

var first =
    Compose("Hello world");

var second =
    Compose("Hello world");

Console.WriteLine(
    first.AsSpan()
         .SequenceEqual(second));

For identical inputs, the generated MIDI can be compared directly.

That's a very different engineering goal from probabilistic generation.

Deterministic Doesn't Mean Boring

Repeatability does not mean every input sounds the same.

Change:

Hello world

to:

Hello from SoundScript

and the generated musical structure changes.

Conceptually:

Text A
   ↓
 Rules
   ↓
Melody A

and:

Text B
   ↓
 Rules
   ↓
Melody B

The important guarantee is:

Text A
   ↓
Same Rules
   ↓
Melody A

every single time.

Think of It Like a Compiler

A useful mental model isn't:

Text
  ↓
AI Musician

Instead think:

Text
  ↓
Transformation Pipeline
  ↓
Music

Developers already work with systems like this every day.

Compiler

Source Code
     ↓
    Parse
     ↓
Intermediate Representation
     ↓
Machine Code

Template Engine

Template + Data
         ↓
      Render
         ↓
     Document

Code Generator

Schema
   ↓
Generator
   ↓
Code

SoundScript

Text
  ↓
Linguistic Analysis
  ↓
Musical Gestures
  ↓
Musical Program
  ↓
MIDI

Generated doesn't automatically imply random.

Use the CLI

The same workflow is available from the SoundScript CLI.

soundscript compose \
  "Twinkle twinkle little star" \
  twinkle.mid

Or from a repository checkout:

dotnet run \
  --project src/SoundScript.Cli \
  -- compose \
  "Twinkle twinkle little star" \
  twinkle.mid

Generate the same text twice:

dotnet run --project src/SoundScript.Cli -- compose "Hello world" first.mid

dotnet run --project src/SoundScript.Cli -- compose "Hello world" second.mid

The workflow remains simple:

Text
  ↓
Compose
  ↓
MIDI

This makes text-to-music useful both in application code and automation pipelines.

Generated Music Doesn't Have to Be the Final Result

One interesting possibility is using generated music as a starting point.

Text
  ↓
Composition
  ↓
SoundScript Source
  ↓
Manual Edit
  ↓
Render

Instead of:

Generate
   ↓
Accept Result

you get:

Generate
   ↓
Inspect
   ↓
Edit
   ↓
Render

This feels much closer to code generation than AI prompting.

The generated material becomes editable.

Developers stay in control.

Example: Refining Generated Music

Suppose the generated material contains:

C4 e
E4 e
G4 q

You might decide to change it to:

C4 q
G4 q
C5 h

Or adjust:

tempo 96

to:

tempo 120

Render again.

The workflow becomes:

Generated Structure
        ↓
Developer Edit
        ↓
New Output

That's a blend of automation and deliberate authorship.

Use Case: Stable Musical Identities

Imagine an application containing named entities:

Alpha
Bravo
Charlie
Delta

Each name can deterministically generate its own motif.

Alpha
  ↓
Motif A

Bravo
  ↓
Motif B

Charlie
  ↓
Motif C

Every occurrence of "Alpha" produces the same musical identity.

Potential applications include:

🎮 Games
📊 Sonification
🎓 Education
♿ Accessibility research
🖥 Interactive systems

Use Case: Procedural Games

Imagine a game generates locations dynamically:

Aurora Station
Crimson Valley
Echo Ridge
Silent Harbor

Instead of manually designing audio for every generated location:

Location Name
        ↓
Text Composition
        ↓
Location Motif

The same location name always generates the same identity.

That's extremely useful for procedural worlds.

Use Case: Education

Text-to-melody can help students explore relationships between language and sound.

Try entering:

computer

then:

automation

then:

deterministic audio

Students can compare the resulting structures.

Because the transformation is rule-based, the system can explain why a result occurred.

That's much harder with purely generative systems.

Use Case: Automated Testing

A deterministic composer naturally fits testing workflows.

"Hello world"
      ↓
Known MIDI

Generate twice:

var first =
    Compose("Hello world");

var second =
    Compose("Hello world");

Assert.True(
    first.AsSpan()
         .SequenceEqual(second));

Or verify a hash:

using System.Security.Cryptography;

var midi =
    Compose("Hello world");

var hash =
    Convert.ToHexString(
        SHA256.HashData(midi));

Console.WriteLine(hash);

The text itself becomes a reproducible media fixture.

Use Case: Data Sonification

Labels can become stable auditory signatures.

Imagine:

service-authentication
service-payments
service-orders
service-shipping

Each service generates its own musical identity.

Service Name
       ↓
Musical Motif

Generation remains deterministic, allowing users to learn those identities over time.

Deterministic Doesn't Mean Intelligent

An important distinction:

SoundScript doesn't claim to understand the meaning of a sentence.

For example:

The deployment succeeded

and

The deployment failed

produce different musical structures because they're different inputs.

But the composer is not automatically deciding:

Success = Happy Music
Failure = Sad Music

unless your application explicitly defines those rules.

This keeps behaviour predictable and inspectable.

Let Application Logic Handle Meaning

In many systems, semantics belong in the application.

For example:

Status = Success
Text = Deployment Complete

The application might choose:

tempo 120
dynamic mf

while the text composer generates melodic material.

Conceptually:

Application Meaning
         +
Text-Derived Motif
         ↓
Final Musical Behaviour

This separation keeps business logic where it belongs.

Text-to-Music as Software Architecture

The bigger idea isn't turning sentences into tunes.

It's treating musical generation like any other software transformation.

Instead of:

Developer
    ↓
Creates Asset
    ↓
Stores Binary File

you can have:

Data
  ↓
Rules
  ↓
Musical Structure
  ↓
Media

That's a pattern software engineers already understand.

Where This Approach Fits

🎓 Education

Teach relationships between language and music.

🎮 Games

Generate stable motifs for people, locations, and factions.

🧪 Testing

Create reproducible MIDI fixtures from text.

📊 Sonification

Give labels and identifiers musical identities.

♿ Accessibility

Explore alternative non-visual representations.

🧬 Research

Run repeatable language-to-music experiments.

🛠 Developer Tooling

Generate music from build metadata, logs, or structured text.

When Should You Use AI Instead?

If your goal is:

Create an emotional two-minute orchestral score with piano, strings, and a cinematic climax.

then an AI music system is probably the better fit.

If your goal is:

This exact input should always produce the same inspectable musical result inside my application.

then deterministic composition becomes much more interesting.

The distinction is simple:

AI Music

Creative Interpretation

SoundScript Composition

Predictable Transformation

Both are valuable.

They support different architectures.

Try It Yourself

Install SoundScript:

dotnet add package SoundScript --version 13.0.0

Create a small composer:

using SoundScript.Compose;
using SoundScript.Midi;

static byte[] ComposeText(
    string text)
{
    var program =
        PhonemeComposer.ComposeProgram(
            text);

    using var stream =
        new MemoryStream();

    MidiGenerator.Write(
        program,
        stream);

    return stream.ToArray();
}

Generate a melody:

var midi =
    ComposeText(
        "Hello SoundScript");

File.WriteAllBytes(
    "hello.mid",
    midi);

Generate it again:

var first =
    ComposeText(
        "Hello SoundScript");

var second =
    ComposeText(
        "Hello SoundScript");

Console.WriteLine(
    first.AsSpan()
         .SequenceEqual(second));

Then change the text and compare the result:

Hello deterministic music

The workflow is straightforward:

Write Text
     ↓
Compose
     ↓
Generate MIDI
     ↓
Inspect
     ↓
Modify
     ↓
Repeat

Try SoundScript

dotnet add package SoundScript --version 13.0.0

Resources

🌐 Website: https://soundscript.net/
📦 NuGet: https://www.nuget.org/packages/SoundScript
💻 GitHub: https://github.com/dharangutti/sound-script
📚 Documentation: https://soundscript.net/doc.html?p=documentation.md
🚀 V13 Release: https://github.com/dharangutti/sound-script/releases/tag/v13.0.0

SoundScript Developer Series

Deterministic Audio Fixtures for Automated Testing in .NET

Coming Next

Generate Background Music from JSON in .NET

We'll connect application configuration and runtime data to SoundScript, turning ordinary JSON into predictable, programmable musical behaviour.

SoundScript

Write audio and media like code.

📧 info@dharangutti.in

🌐 https://www.dharangutti.in/

Deterministic Audio Fixtures for Automated Testing in .NET

Anup Jayant Dharangutti — Fri, 18 Sep 2026 11:46:59 +0000

We generate JSON fixtures, images, database records, and API payloads for tests. Why not audio?

Most engineering teams already treat test data as code.

We generate:

JSON fixtures
Database records
API payloads
Configuration files
Images

Yet audio is often handled differently.

A WAV file gets copied into a test directory and remains there as a binary asset that nobody wants to touch.

tests/
└── fixtures/
    └── notification.wav

The test passes.

The build is green.

But a future developer reviewing the repository may have no idea:

What sound does this contain?
Which notes are being played?
Why was it generated?
Can it be reproduced?
Was that binary change intentional?

In many projects, the WAV file becomes the only source of truth.

What if the source of the sound was the artifact you reviewed instead?

That's where SoundScript becomes interesting.

The Problem with Binary Audio Fixtures

Consider a pull request containing:

notification.wav changed

What exactly changed?

Tempo?
Pitch?
Instrument?
Duration?
Volume?
Entire musical phrase?

Without specialised tooling, the answer is usually:

"I don't know. Someone changed the WAV."

Compare that to a textual audio definition:

tempo 120

track notification {
    instrument piano
    mf

    C4 e
    E4 e
    G4 q
}

Now the intent is visible.

A code reviewer can understand the change before listening to anything.

Install SoundScript

SoundScript 13 targets .NET 10.

dotnet add package SoundScript --version 13.0.0

Create a deterministic audio fixture directly from C#:

using SoundScript;

var source = """
    tempo 120

    track fixture {
        instrument piano

        C4 e
        E4 e
        G4 e
        B4 e
        D5 e
        G4 e
    }
    """;

var compilation =
    SoundScriptEngine.Compile(source);

var wav = compilation.RenderWave();
var midi = compilation.RenderMidi();

File.WriteAllBytes("fixture.wav", wav);
File.WriteAllBytes("fixture.mid", midi);

The key idea isn't that we generated a WAV file.

The important part is that the fixture now has a readable, reviewable definition:

tempo 120

track fixture {
    instrument piano

    C4 e
    E4 e
    G4 e
    B4 e
    D5 e
    G4 e
}

Treat Audio Like Generated Test Data

Instead of this:

fixture.wav

your workflow becomes:

Test Intent
      ↓
SoundScript Source
      ↓
Compile
      ↓
WAV / MIDI Fixture
      ↓
System Under Test

This is the same pattern developers already use elsewhere.

Schema
   ↓
Generated Client

Template
   ↓
Document

Source Code
   ↓
Executable

SoundScript
   ↓
Audio Fixture

Audio stops being a mysterious binary asset and becomes another generated artifact.

Verify Deterministic Rendering

One of the most useful properties for testing is reproducibility.

Render the same source twice:

var compilation =
    SoundScriptEngine.Compile(source);

var first =
    compilation.RenderWave();

var second =
    compilation.RenderWave();

var identical =
    first.AsSpan().SequenceEqual(second);

Console.WriteLine(identical);

Or make it a test:

Assert.True(
    first.AsSpan().SequenceEqual(second));

If the source and rendering conditions remain unchanged, SoundScript is designed to produce repeatable output.

That means the generated audio itself can participate in automated regression testing.

Add SHA-256 Regression Checks

In many cases, you don't need to store expected byte arrays.

A hash is enough.

using System.Security.Cryptography;

var wav =
    SoundScriptEngine
        .Compile(source)
        .RenderWave();

var hash =
    Convert.ToHexString(
        SHA256.HashData(wav));

Console.WriteLine(hash);

Conceptually:

SoundScript Source
        ↓
    Render WAV
        ↓
      SHA-256
        ↓
Expected Hash?
    ↙       ↘
 PASS   Investigate

Generated audio can now be validated much like any other build artifact.

Example: Testing Audio Upload Pipelines

Suppose you're testing an audio upload endpoint.

Many teams would commit a WAV fixture:

upload-test.wav

Instead, generate one during test execution.

var wav =
    SoundScriptEngine
        .Compile("""
            tempo 100

            track upload {
                instrument piano

                C4 q
                E4 q
                G4 h
            }
            """)
        .RenderWave();

await File.WriteAllBytesAsync(
    "upload-test.wav",
    wav);

Now the fixture is:

✅ Generated

✅ Readable

✅ Reproducible

✅ Versionable

✅ Easy to modify

The musical intent lives inside the test itself.

Store Fixture Sources in Files

For larger test suites, keep the musical definitions separate.

tests/
└── fixtures/
    ├── notification.ss
    ├── warning.ss
    └── failure.ss

Then load them:

using SoundScript;

var compilation =
    SoundScriptEngine.CompileFile(
        "tests/fixtures/notification.ss");

var wav =
    compilation.RenderWave();

Now audio changes show up naturally in pull requests.

Instead of:

Binary files differ

you review:

-tempo 100
+tempo 120

-track notification {
-    C4 q E4 q
+track notification {
+    C4 e
+    E4 e
+    G4 q
}

That's significantly easier to reason about.

A Simple Deterministic Fixture Test

A complete test might look like this:

using SoundScript;

var source = """
    tempo 120

    track fixture {
        instrument piano

        C4 e
        E4 e
        G4 q
    }
    """;

var compilation =
    SoundScriptEngine.Compile(source);

var first =
    compilation.RenderWave();

var second =
    compilation.RenderWave();

Assert.True(
    first.AsSpan().SequenceEqual(second));

The same idea applies to MIDI:

var firstMidi =
    compilation.RenderMidi();

var secondMidi =
    compilation.RenderMidi();

Assert.True(
    firstMidi.AsSpan()
        .SequenceEqual(secondMidi));

The tests aren't just verifying behaviour.

They're also verifying reproducibility.

Should Every Test Compare Exact Bytes?

No.

And that's an important distinction.

Exact byte comparisons are useful when renderer stability matters.

Many audio tests care about different guarantees:

Is the WAV valid?
Is the duration correct?
Is the sample rate correct?
Is the channel count correct?
Does the MIDI contain expected notes?
Is the file size reasonable?

Choose assertions based on what the test is actually promising.

Think in Testing Layers

A useful strategy is to separate validation into layers.

Level 1: Format Validation

Generated Bytes
       ↓
 Format Parser
       ↓
Valid?

Is the output a valid WAV or MIDI file?

Level 2: Structural Validation

Verify characteristics such as:

Duration
Sample rate
Channels
Tracks
Notes
Tempo

Level 3: Deterministic Regression

Verify exact reproducibility.

Expected Hash
      =
 Actual Hash

SoundScript makes this level possible without forcing every test to use it.

CI/CD Gets Interesting Too

This pattern isn't limited to testing.

Build and deployment results can also be represented as sound.

Imagine:

0 failures
    ↓
Success motif

Few failures
    ↓
Warning motif

Many failures
    ↓
Failure motif

Conceptually:

tempo 120

track passed {
    mf

    G4 e
    G4 e
    G4 e
    G4 e
}

track failed {
    f

    C3 e
    C3 e
}

The same test results produce the same audio.

That's deterministic sonification.

Why Sonify CI?

Not as a replacement for dashboards.

As an additional information channel.

Potential use cases include:

Long-running test environments
Monitoring stations
Accessibility experiments
Engineering demonstrations
Industrial control systems
Background build awareness

The goal isn't to add sound everywhere.

The goal is to use sound when sound communicates useful information.

Where Deterministic Audio Fixtures Fit Best

🧪 Media Upload Testing

Generate valid WAV files during setup.

🔔 Notification Systems

Verify generated notification sounds.

🎮 Games

Create repeatable audio scenarios.

♿ Accessibility Testing

Produce controlled audio feedback.

🚦 Monitoring Applications

Validate state-to-sound mappings.

🏭 Industrial Systems

Test machine-state signalling.

🔄 CI/CD Experiments

Generate repeatable build sonification.

📦 Demo Data Generation

Create reproducible audio assets during builds.

Audio as Source Code

The bigger idea isn't WAV generation.

It's moving intent into something developers can inspect.

Instead of:

mysterious binary asset

you have:

human-readable source
        ↓
deterministic build
        ↓
binary artifact

Developers already embrace this model everywhere else:

Source Code → Executable

Schema → Client

Template → Document

Build Script → Package

SoundScript → Audio

SoundScript applies the same engineering principle to sound.

Try It Yourself

Install SoundScript:

dotnet add package SoundScript --version 13.0.0

Create a simple fixture:

tempo 120

track fixture {
    instrument piano
    mf

    C4 e
    E4 e
    G4 q
}

Render twice:

var compilation =
    SoundScriptEngine.Compile(source);

var a =
    compilation.RenderWave();

var b =
    compilation.RenderWave();

Console.WriteLine(
    a.AsSpan().SequenceEqual(b));

Then compute a hash:

var hash =
    Convert.ToHexString(
        SHA256.HashData(a));

Console.WriteLine(hash);

You now have an audio fixture that can be:

Written
   ↓
Reviewed
   ↓
Generated
   ↓
Hashed
   ↓
Tested
   ↓
Regenerated

That's a very software-engineering way to think about audio.

Try SoundScript

dotnet add package SoundScript --version 13.0.0

Resources

🌐 Website: https://soundscript.net/
📦 NuGet: https://www.nuget.org/packages/SoundScript
💻 GitHub: https://github.com/dharangutti/sound-script
📚 Documentation: https://soundscript.net/doc.html?p=documentation.md
🚀 V13 Release: https://github.com/dharangutti/sound-script/releases/tag/v13.0.0

SoundScript Developer Series

Generate MIDI and WAV from the Same C# Source

Coming Next

Text-to-Music with SoundScript: Deterministic Composition Instead of Prompting

We'll take ordinary text, transform it into musical structures, and explore why deterministic composition differs fundamentally from probabilistic AI-generated music.

SoundScript

Write audio and media like code.

📧 info@dharangutti.in

🌐 https://www.dharangutti.in/

Generate MIDI and WAV from the Same C# Source with SoundScript

Anup Jayant Dharangutti — Fri, 18 Sep 2026 11:46:21 +0000

Less audio plumbing. More programmable sound.

Generating a MIDI file in C# isn't particularly difficult.

Generating MIDI, rendering audio, keeping everything reproducible, and making the musical source easy to review in Git is where complexity starts to accumulate.

SoundScript takes a different approach.

Instead of manually creating MIDI events or building audio pipelines, you describe musical intent and let SoundScript render the outputs.

Let's build something.

Install SoundScript

SoundScript 13 targets .NET 10.

dotnet add package SoundScript --version 13.0.0

Create a small C# program:

using SoundScript;

var cue = SoundScriptEngine.Compile(
    "tempo 120 track cue { instrument piano mf C4 e E4 e G4 q }");

File.WriteAllBytes("success.mid", cue.RenderMidi());
File.WriteAllBytes("success.wav", cue.RenderWave());

That's it.

One musical definition produces two outputs:

🎹 MIDI
🔊 WAV

No DAW project.

No MIDI event plumbing.

No duplicated definitions.

The Musical Source

Here's the SoundScript source in a more readable format:

tempo 120

track cue {
    instrument piano
    mf

    C4 e
    E4 e
    G4 q
}

Where:

Symbol	Meaning
C4, E4, G4	Notes
e	Eighth note
q	Quarter note
mf	Mezzo-forte dynamic

Instead of manually creating:

note-on events
note-off events
timestamps
velocities

you describe the musical idea and let SoundScript generate the implementation details.

Why Use a Language Instead of a MIDI API?

Libraries such as DryWetMIDI are excellent when you need direct control over MIDI data.

They expose concepts like:

Notes
Timed events
Tempo maps
Patterns
MIDI devices
Playback
File manipulation

That's exactly what a MIDI library should do.

SoundScript operates at a higher level.

Traditional MIDI Workflow

Application
    ↓
Create musical objects
    ↓
Manage timing
    ↓
Build MIDI structure
    ↓
Serialize MIDI

SoundScript Workflow

Application
    ↓
Describe music
    ↓
Compile
    ↓
Render MIDI / WAV

SoundScript isn't trying to replace MIDI libraries.

It provides a different abstraction when your application cares about musical intent rather than individual MIDI events.

If you're building a MIDI editor, DAW, or hardware integration tool, a MIDI library is likely the right choice.

If your application simply needs to say:

Play this deterministic musical cue.

then a higher-level representation can dramatically reduce application code.

Change the Music Without Changing the Application

Suppose a designer wants a different sound.

Only the musical definition changes:

var cue = SoundScriptEngine.Compile("""
    tempo 96

    track notification {
        instrument violin
        mp

        C4 q
        E4 q
        G4 q
        C5 h
    }
    """);

The rendering code remains identical:

File.WriteAllBytes(
    "notification.mid",
    cue.RenderMidi());

File.WriteAllBytes(
    "notification.wav",
    cue.RenderWave());

Separating musical behaviour from application logic becomes increasingly useful as audio requirements evolve.

One Source, Multiple Outputs

MIDI and WAV serve different purposes.

MIDI

MIDI contains symbolic musical information.

Useful for:

Sequencing
Editing
DAW workflows
MIDI processing
Compact storage

WAV

WAV contains rendered audio.

Useful for:

Direct playback
HTTP delivery
Asset generation
Application packaging
Audio processing pipelines

Using separate systems for MIDI and audio often means maintaining multiple representations of the same cue.

SoundScript generates both from a single source:

                ┌──→ MIDI
SoundScript ────┤
                └──→ WAV

One definition.

Two outputs.

No duplication.

Move Music Out of C

Embedding short cues in code is convenient.

For larger projects, store music in .ss files.

scores/
└── notification.ss

Load and compile:

using SoundScript;

var compilation =
    SoundScriptEngine.CompileFile(
        "scores/notification.ss");

File.WriteAllBytes(
    "notification.wav",
    compilation.RenderWave());

Now musical content can evolve independently of application code.

Audio Becomes Versionable

One of the most interesting side effects of representing music as text is that audio becomes part of normal software workflows.

You can:

✅ Commit audio definitions to Git
✅ Review them in pull requests
✅ Compare changes with diffs
✅ Regenerate assets during builds
✅ Automate fixture generation
✅ Track exactly what changed

Instead of comparing:

notification-old.wav
notification-new.wav

you review:

-tempo 100
+tempo 120

-track alert {
-    C4 q E4 q
+track alert {
+    C4 e
+    E4 e
+    G4 q
}

For developers, that's a much more useful workflow.

Deterministic Rendering

SoundScript is designed around reproducible generation.

Given the same:

SoundScript source
Renderer version
Render options
Referenced assets

the output is designed to be repeatable.

That enables workflows such as:

Source
   ↓
Build
   ↓
WAV / MIDI
   ↓
Hash
   ↓
Regression Test

This becomes particularly valuable when audio is part of:

Automated testing
CI/CD pipelines
Generated assets
Research workflows
Reproducible demonstrations

We'll explore this in a future article.

Interesting Use Cases

🔔 Application Notifications

Generate cues for:

Success
Warning
Failure
New messages
Deployment completion

🎮 Game Prototypes

Create state-driven audio behaviours without manually managing countless variations.

🧪 Automated Testing

Generate WAV and MIDI fixtures as part of test setup.

🚦 Monitoring Systems

Map operational state into repeatable audio signals.

♿ Accessibility Experiments

Explore alternative non-visual feedback mechanisms.

🎓 Education

Programmatically demonstrate:

Notes
Intervals
Tempo
Dynamics
Musical structure

🏭 Industrial Applications

Represent machine or process state through structured audio.

When Not to Use SoundScript

SoundScript is not a replacement for a DAW.

A traditional DAW remains the right tool for:

Recording
Mixing
Mastering
Complex arrangements
Plugin-heavy workflows
Live performance

SoundScript addresses a different question:

What if audio is part of your application's programmable behaviour?

Try Modifying the Example

Start with:

C4 e
E4 e
G4 q

Then experiment.

Change the tempo:

tempo 80

Change the instrument:

instrument violin

Change the dynamics:

Change the phrase:

C4 q
G4 q
C5 h

Recompile.

Render again.

Listen to the WAV.

Inspect the MIDI.

Commit the source.

That's the entire SoundScript workflow:

Write
  ↓
Compile
  ↓
Render
  ↓
Version

Get Started

Install SoundScript:

dotnet add package SoundScript --version 13.0.0

Resources

🌐 Website: https://soundscript.net/
📦 NuGet: https://www.nuget.org/packages/SoundScript
💻 GitHub: https://github.com/dharangutti/sound-script
📚 Documentation: https://soundscript.net/doc.html?p=documentation.md
🚀 V13 Release: https://github.com/dharangutti/sound-script/releases/tag/v13.0.0

SoundScript Developer Series

This article is part of a series exploring programmable audio with .NET.

Coming next:

Deterministic Audio for Automated Testing in .NET

We'll generate WAV and MIDI fixtures from source, render them repeatedly, and verify the output programmatically.

SoundScript

Write audio and media like code.

📧 info@dharangutti.in

🌐 https://www.dharangutti.in/

DEV Community: Anup Jayant Dharangutti

Procedural Game and Application Audio in .NET

Install SoundScript

Define Event Cues

Turn an Event into Audio

Why Not Just Use WAV Files?

Let Severity Control Dynamics

Let Progression Influence Tempo

Let State Choose the Musical Motif

Combine Multiple Pieces of State

Procedural Audio Without DSP

Static vs Procedural Architectures

Static Assets

Procedural Audio

The Best Architecture Is Often Hybrid

Cache Generated Audio

Procedural Doesn't Have to Mean Runtime

Example: Health Warning System

Example: Achievement Rarity

Example: Monitoring Applications

Procedural Rules Are Reviewable

Generated Audio Can Be Tested

A Reusable Renderer

What the Application Owns

Where Procedural Audio Fits Best

🎮 Game Prototypes

🔔 Application Notifications

🚦 Monitoring Systems

♿ Accessibility

🏭 Industrial Applications

🧪 Automated Testing

🎓 Education

🛠 Developer Tooling

When Static Assets Are Still Better

One Simple Rule

The Bigger Idea

Try It Yourself

Try SoundScript

Resources

SoundScript Developer Series

Previous

In This Series

Generate Background Music from JSON in .NET

Install SoundScript

Start with a Simple Configuration

Map JSON into SoundScript

Why Not Just Store a WAV File?

Example: Severity-Driven Audio

Keep Business Logic Outside the Audio Engine

Avoid Passing Arbitrary Source from JSON

A More Realistic Example

Tempo

Dynamic

Motif

JSON Is Control Data, Not Music

Why Not Use an AI Music API?

Comparing Audio Architectures

Static Assets

Generative Music Service

DSP / Custom Synthesis

SoundScript

User-Configurable Notification Profiles

Game State as Audio

Cache Repeated States

Generate Assets at Build Time

Audio Mappings Can Be Tested

A Simple Helper

Where This Approach Fits

🔔 Application Notifications

🎮 Games

🚦 Monitoring

♿ Accessibility Experiments

🏭 Industrial Applications

🎓 Education

🔄 CI/CD

🧪 Automated Testing

When Not to Use It

The Bigger Idea

Try It Yourself

Try SoundScript