# kiptunor/kasaria architecture

> Architecture diagram of the GitHub repository kiptunor/kasaria, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kiptunor/kasaria
- Repository: https://github.com/kiptunor/kasaria

## Overview

Kasaria is a C MIDI synthesizer and playback library. Its documented user path is to initialize the API, load SF2 soundfonts and MIDI or send MIDI events, then synthesize and play or capture audio. README capabilities also include real-time and ahead-of-time rendering, playback controls, multiple soundfonts, effects, and a built-in limiter. The graph reflects documented stages and indexed source references; unsampled implementation details are kept unlinked where invocation evidence is unavailable.

Main entry points: [`src/ksr_synth_out.c`](https://github.com/kiptunor/kasaria/blob/main/src/ksr_synth_out.c) (Audio rendering), [`src/ksr_midi_player.c`](https://github.com/kiptunor/kasaria/blob/main/src/ksr_midi_player.c) (MIDI input), [`src/kasaria.h`](https://github.com/kiptunor/kasaria/blob/main/src/kasaria.h) (Kasaria API), [`src/ksr_voice_mix.c`](https://github.com/kiptunor/kasaria/blob/main/src/ksr_voice_mix.c) (Voice mixing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Public API"]
  node_api["Kasaria API<br/>[kasaria.h]"]
  node_instance["Instance setup<br/>[ksr.c]"]
  node_configuration["Synth configuration<br/>[ksr_config.c]"]
end

subgraph group_midi["MIDI Playback"]
  node_midi_input["MIDI input<br/>[ksr_midi_player.c]"]
  node_midi_file["MIDI file loading<br/>[ksr_midi_loader.c]"]
  node_playback["Playback controls<br/>[ksr_midi_player.c]"]
end

subgraph group_synth["Synthesis Engine"]
  node_instrument["Instrument setup<br/>[ksr_instruments.c]"]
  node_synth_core["Voice synthesis<br/>[ksr_synth_base.c]"]
  node_voice_mix["Voice mixing<br/>[ksr_voice_mix.c]"]
  node_tables["Synthesis tables<br/>[ksr_tables.c]"]
  node_filter["Filtering<br/>[ksr_filter.c]"]
end

subgraph group_audio["Audio Processing"]
  node_render["Audio rendering<br/>[ksr_synth_out.c]"]
  node_resampler["Resampling<br/>[ksr_resample.c]"]
  node_chorus["Chorus<br/>[ksr_chorus.c]"]
  node_chorus_dsp["Chorus DSP<br/>[ksr_sk_chorus.c]"]
  node_reverb["Reverb control<br/>[ksr_reverb.c]"]
  node_reverb_dsp["Reverb DSP"]
  node_audio_device["Audio device<br/>[miniaudio.h]"]
end

subgraph group_soundfonts["SoundFonts"]
  node_soundfont_loader["SF2 loading<br/>[ksr_sf2_loader.c]"]
  node_soundfont_data["SF2 data<br/>[ksr_sf2.c]"]
end

node_user(("Library user"))
node_audio_sink(("Playback or capture"))

node_user -->|"calls API"| node_api
node_api -->|"initializes"| node_instance
node_api -->|"configures"| node_configuration
node_user -->|"sends events"| node_midi_input
node_user -->|"loads MIDI"| node_midi_file
node_midi_input -->|"selects programs"| node_instrument
node_midi_input -->|"controls playback"| node_playback
node_user -->|"loads SF2"| node_soundfont_loader
node_soundfont_loader -->|"loads soundfont"| node_soundfont_data
node_instrument -->|"uses presets"| node_soundfont_data
node_midi_input -.->|"drives voices"| node_synth_core
node_synth_core -.->|"mixes voices"| node_voice_mix
node_voice_mix -.->|"filters audio"| node_filter
node_voice_mix -.->|"uses lookup tables"| node_tables
node_user -->|"renders offline"| node_render
node_render -.->|"resamples audio"| node_resampler
node_render -.->|"applies chorus"| node_chorus
node_chorus -->|"delegates DSP"| node_chorus_dsp
node_render -.->|"applies reverb"| node_reverb
node_reverb -->|"delegates DSP"| node_reverb_dsp
node_render -.->|"outputs audio"| node_audio_device
node_audio_device -->|"plays or captures"| node_audio_sink

click node_api "https://github.com/kiptunor/kasaria/blob/main/src/kasaria.h"
click node_instance "https://github.com/kiptunor/kasaria/blob/main/src/ksr.c"
click node_configuration "https://github.com/kiptunor/kasaria/blob/main/src/ksr_config.c"
click node_midi_input "https://github.com/kiptunor/kasaria/blob/main/src/ksr_midi_player.c"
click node_midi_file "https://github.com/kiptunor/kasaria/blob/main/src/ksr_midi_loader.c"
click node_playback "https://github.com/kiptunor/kasaria/blob/main/src/ksr_midi_player.c"
click node_instrument "https://github.com/kiptunor/kasaria/blob/main/src/ksr_instruments.c"
click node_synth_core "https://github.com/kiptunor/kasaria/blob/main/src/ksr_synth_base.c"
click node_voice_mix "https://github.com/kiptunor/kasaria/blob/main/src/ksr_voice_mix.c"
click node_tables "https://github.com/kiptunor/kasaria/blob/main/src/ksr_tables.c"
click node_filter "https://github.com/kiptunor/kasaria/blob/main/src/ksr_filter.c"
click node_soundfont_loader "https://github.com/kiptunor/kasaria/blob/main/src/soundfont/sf2/ksr_sf2_loader.c"
click node_soundfont_data "https://github.com/kiptunor/kasaria/blob/main/src/soundfont/sf2/ksr_sf2.c"
click node_render "https://github.com/kiptunor/kasaria/blob/main/src/ksr_synth_out.c"
click node_resampler "https://github.com/kiptunor/kasaria/blob/main/src/ksr_resample.c"
click node_chorus "https://github.com/kiptunor/kasaria/blob/main/src/channel_fx/chorus/ksr_chorus.c"
click node_chorus_dsp "https://github.com/kiptunor/kasaria/blob/main/src/channel_fx/chorus/ksr_sk_chorus.c"
click node_reverb "https://github.com/kiptunor/kasaria/blob/main/src/channel_fx/reverb/ksr_reverb.c"
click node_reverb_dsp "https://github.com/kiptunor/kasaria/blob/main/src/channel_fx/reverb/ksr_reverb_effect.c"
click node_audio_device "https://github.com/kiptunor/kasaria/blob/main/src/ext_deps/miniaudio/miniaudio.h"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_api,node_instance,node_configuration,node_user toneBlue
class node_midi_input,node_midi_file,node_playback toneAmber
class node_instrument,node_synth_core,node_voice_mix,node_tables,node_filter toneMint
class node_render,node_resampler,node_chorus,node_chorus_dsp,node_reverb,node_reverb_dsp,node_audio_device toneRose
class node_soundfont_loader,node_soundfont_data,node_audio_sink toneIndigo
```

## Components

### Public API

- [Kasaria API](https://github.com/kiptunor/kasaria/blob/main/src/kasaria.h): `src/kasaria.h`
- [Instance setup](https://github.com/kiptunor/kasaria/blob/main/src/ksr.c): `src/ksr.c`
- [Synth configuration](https://github.com/kiptunor/kasaria/blob/main/src/ksr_config.c): `src/ksr_config.c`

### MIDI Playback

- [MIDI input](https://github.com/kiptunor/kasaria/blob/main/src/ksr_midi_player.c): `src/ksr_midi_player.c`
- [MIDI file loading](https://github.com/kiptunor/kasaria/blob/main/src/ksr_midi_loader.c): `src/ksr_midi_loader.c`
- [Playback controls](https://github.com/kiptunor/kasaria/blob/main/src/ksr_midi_player.c): `src/ksr_midi_player.c`

### Synthesis Engine

- [Instrument setup](https://github.com/kiptunor/kasaria/blob/main/src/ksr_instruments.c): `src/ksr_instruments.c`
- [Voice synthesis](https://github.com/kiptunor/kasaria/blob/main/src/ksr_synth_base.c): `src/ksr_synth_base.c`
- [Voice mixing](https://github.com/kiptunor/kasaria/blob/main/src/ksr_voice_mix.c): `src/ksr_voice_mix.c`
- [Synthesis tables](https://github.com/kiptunor/kasaria/blob/main/src/ksr_tables.c): `src/ksr_tables.c`
- [Filtering](https://github.com/kiptunor/kasaria/blob/main/src/ksr_filter.c): `src/ksr_filter.c`

### Audio Processing

- [Audio rendering](https://github.com/kiptunor/kasaria/blob/main/src/ksr_synth_out.c): `src/ksr_synth_out.c`
- [Resampling](https://github.com/kiptunor/kasaria/blob/main/src/ksr_resample.c): `src/ksr_resample.c`
- [Chorus](https://github.com/kiptunor/kasaria/blob/main/src/channel_fx/chorus/ksr_chorus.c): `src/channel_fx/chorus/ksr_chorus.c`
- [Chorus DSP](https://github.com/kiptunor/kasaria/blob/main/src/channel_fx/chorus/ksr_sk_chorus.c): `src/channel_fx/chorus/ksr_sk_chorus.c`
- [Reverb control](https://github.com/kiptunor/kasaria/blob/main/src/channel_fx/reverb/ksr_reverb.c): `src/channel_fx/reverb/ksr_reverb.c`
- [Reverb DSP](https://github.com/kiptunor/kasaria/blob/main/src/channel_fx/reverb/ksr_reverb_effect.c): `src/channel_fx/reverb/ksr_reverb_effect.c`
- [Audio device](https://github.com/kiptunor/kasaria/blob/main/src/ext_deps/miniaudio/miniaudio.h): `src/ext_deps/miniaudio/miniaudio.h`

### SoundFonts

- [SF2 loading](https://github.com/kiptunor/kasaria/blob/main/src/soundfont/sf2/ksr_sf2_loader.c): `src/soundfont/sf2/ksr_sf2_loader.c`
- [SF2 data](https://github.com/kiptunor/kasaria/blob/main/src/soundfont/sf2/ksr_sf2.c): `src/soundfont/sf2/ksr_sf2.c`

### Other components

- **Library user**
- **Playback or capture**

## Connections

- Library user → Kasaria API: calls API (evidence: `README.md`)
- Kasaria API → Instance setup: initializes (evidence: `src/ksr.c`)
- Kasaria API → Synth configuration: configures (evidence: `src/ksr_config.c`)
- Library user → MIDI input: sends events (evidence: `README.md`)
- Library user → MIDI file loading: loads MIDI (evidence: `README.md`)
- MIDI input → Instrument setup: selects programs (evidence: `src/ksr_midi_player.c`)
- MIDI input → Playback controls: controls playback (evidence: `src/ksr_midi_player.c`)
- Library user → SF2 loading: loads SF2 (evidence: `README.md`)
- SF2 loading → SF2 data: loads soundfont (evidence: `src/soundfont/sf2/ksr_sf2_loader.c`)
- Instrument setup → SF2 data: uses presets (evidence: `src/ksr_instruments.c`)
- MIDI input → Voice synthesis: drives voices
- Voice synthesis → Voice mixing: mixes voices
- Voice mixing → Filtering: filters audio
- Voice mixing → Synthesis tables: uses lookup tables
- Library user → Audio rendering: renders offline (evidence: `README.md`)
- Audio rendering → Resampling: resamples audio
- Audio rendering → Chorus: applies chorus
- Chorus → Chorus DSP: delegates DSP (evidence: `src/channel_fx/chorus/ksr_chorus.c`)
- Audio rendering → Reverb control: applies reverb
- Reverb control → Reverb DSP: delegates DSP (evidence: `src/channel_fx/reverb/ksr_reverb.c`)
- Audio rendering → Audio device: outputs audio
- Audio device → Playback or capture: plays or captures (evidence: `README.md`)
