# djennirr/soundlab-studio architecture

> Architecture diagram of the GitHub repository djennirr/soundlab-studio, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/djennirr/soundlab-studio
- Repository: https://github.com/djennirr/soundlab-studio

## Overview

##### Project type and purpose
- This is a C++-based desktop audio processing/synthesis application (“soundlab-studio”).
- It provides a node-based audio graph editor (using ImGui + imgui-node-editor), various audio modules (oscillator, filter, ADSR, reverb, distortion, sampler, etc.), and real-time audio I/O via SDL2.

##### File structure
- Top-level: CMakeLists.txt, main.cpp, debug.sh/script.sh, README.md
- libs/: third-party dependencies
- SDL2 (runtime audio I/O & windowing)
- imgui + imgui-node-editor (UI & graph editor)
- json (presets/config serialization)
- src/: core audio engine & modules
- Module base classes: Module, AudioModule, ControlModule
- DSP modules: Oscillator, NoiseGenerator, Filter, Distortion, Reverb, ADSR, Sampler, Adder, etc.
- AudioOutput: final SDL2 sink
- Control: UI ↔ module parameters
- Oscilloscope: visualization
- samples/: example WAV files for the sampler module
- themes/: UI theming code

##### README for additional insights
- README only provides the project name; the code structure is the main source of architectural information.

##### Detail
- Graph manager or scheduler that determines module execution order
- Build/dependency chain: CMake → src + libs → executable

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% GUI Layer
    subgraph "GUI Layer"
        Main["main.cpp"]:::ui
        ImGui["ImGui Library"]:::ui
        NodeEditor["Node Editor"]:::ui
    end

    %% Control Layer
    subgraph "Control Layer"
        ControlLogic["Control.cpp/.h"]:::control
        ControlModule["ControlModule.h"]:::control
    end

    %% Audio Engine
    subgraph "Audio Engine"
        GraphMgr["Graph Manager"]:::audio
        subgraph "Core Infrastructure"
            ModuleBase["Module.h/.cpp"]:::audio
            AudioMod["AudioModule.h"]:::audio
            ControlMod["ControlModule.h"]:::control
        end
        subgraph "DSP Modules"
            Osc["Oscillator"]:::audio
            Noise["Noise Generator"]:::audio
            Filter["Filter"]:::audio
            Dist["Distortion"]:::audio
            Reverb["Reverb"]:::audio
            ADSR["ADSR Envelope"]:::audio
            SamplerMod["Sampler"]:::audio
            Adder["Adder"]:::audio
        end
        subgraph "Visualization"
            Scope["Oscilloscope"]:::audio
        end
    end

    %% Audio I/O
    subgraph "Audio I/O"
        AudioOut["AudioOutput (SDL2)"]:::io
        SDL2["SDL2 Library"]:::third
    end

    %% Persistence & Resources
    subgraph "Persistence & Resources"
        JSON["JSON Library"]:::resource
        Samples["Samples (WAV)"]:::resource
        Themes["Themes"]:::resource
    end

    %% Build System & Scripts
    subgraph "Build System & Scripts"
        CMake["CMakeLists.txt"]:::build
        Scripts["debug.sh / script.sh"]:::build
        README["README.md"]:::build
    end

    %% Connections
    Main --> ImGui
    Main --> NodeEditor
    Main --> ControlLogic
    NodeEditor --> ImGui
    NodeEditor -->|sends UI events| ControlLogic
    ControlLogic -->|updates parameters| GraphMgr
    GraphMgr -->|manages execution| Osc
    GraphMgr --> Noise
    GraphMgr --> Filter
    GraphMgr --> Dist
    GraphMgr --> Reverb
    GraphMgr --> ADSR
    GraphMgr --> SamplerMod
    GraphMgr --> Adder
    Osc -->|audio signal| AudioOut
    Noise --> AudioOut
    Filter --> AudioOut
    Dist --> AudioOut
    Reverb --> AudioOut
    ADSR --> AudioOut
    SamplerMod --> AudioOut
    Adder --> AudioOut
    Scope --> AudioOut
    AudioOut --> SDL2
    JSON -->|load/save presets| GraphMgr
    Samples -->|loaded by| SamplerMod
    Themes --> ImGui
    Themes --> NodeEditor
    CMake --> Main
    CMake --> ModuleBase
    CMake --> ImGui
    CMake --> SDL2
    Scripts --> CMake

    %% Click Events
    click Main "https://github.com/djennirr/soundlab-studio/blob/main/main.cpp"
    click ImGui "https://github.com/djennirr/soundlab-studio/tree/main/libs/imgui/"
    click NodeEditor "https://github.com/djennirr/soundlab-studio/tree/main/libs/imgui-node-editor/"
    click ControlLogic "https://github.com/djennirr/soundlab-studio/blob/main/src/Control.cpp"
    click ControlLogic "https://github.com/djennirr/soundlab-studio/blob/main/src/Control.h"
    click ControlModule "https://github.com/djennirr/soundlab-studio/blob/main/src/ControlModule.h"
    click ModuleBase "https://github.com/djennirr/soundlab-studio/blob/main/src/Module.h"
    click ModuleBase "https://github.com/djennirr/soundlab-studio/blob/main/src/Module.cpp"
    click AudioMod "https://github.com/djennirr/soundlab-studio/blob/main/src/AudioModule.h"
    click ControlMod "https://github.com/djennirr/soundlab-studio/blob/main/src/ControlModule.h"
    click Osc "https://github.com/djennirr/soundlab-studio/blob/main/src/Oscillator.h"
    click Osc "https://github.com/djennirr/soundlab-studio/blob/main/src/Oscillator.cpp"
    click Noise "https://github.com/djennirr/soundlab-studio/blob/main/src/NoiseGenerator.h"
    click Noise "https://github.com/djennirr/soundlab-studio/blob/main/src/NoiseGenerator.cpp"
    click Filter "https://github.com/djennirr/soundlab-studio/blob/main/src/Filter.h"
    click Filter "https://github.com/djennirr/soundlab-studio/blob/main/src/Filter.cpp"
    click Dist "https://github.com/djennirr/soundlab-studio/blob/main/src/Distortion.h"
    click Dist "https://github.com/djennirr/soundlab-studio/blob/main/src/Distortion.cpp"
    click Reverb "https://github.com/djennirr/soundlab-studio/blob/main/src/Reverb.h"
    click Reverb "https://github.com/djennirr/soundlab-studio/blob/main/src/Reverb.cpp"
    click ADSR "https://github.com/djennirr/soundlab-studio/blob/main/src/ADSR.h"
    click ADSR "https://github.com/djennirr/soundlab-studio/blob/main/src/ADSR.cpp"
    click SamplerMod "https://github.com/djennirr/soundlab-studio/blob/main/src/Sampler.h"
    click SamplerMod "https://github.com/djennirr/soundlab-studio/blob/main/src/Sampler.cpp"
    click Adder "https://github.com/djennirr/soundlab-studio/blob/main/src/Adder.h"
    click Adder "https://github.com/djennirr/soundlab-studio/blob/main/src/Adder.cpp"
    click Scope "https://github.com/djennirr/soundlab-studio/blob/main/src/Oscilloscope.h"
    click Scope "https://github.com/djennirr/soundlab-studio/blob/main/src/Oscilloscope.cpp"
    click AudioOut "https://github.com/djennirr/soundlab-studio/blob/main/src/AudioOutput.h"
    click AudioOut "https://github.com/djennirr/soundlab-studio/blob/main/src/AudioOutput.cpp"
    click SDL2 "https://github.com/djennirr/soundlab-studio/tree/main/libs/SDL2/"
    click JSON "https://github.com/djennirr/soundlab-studio/tree/main/libs/json/"
    click Samples "https://github.com/djennirr/soundlab-studio/tree/main/samples/"
    click Themes "https://github.com/djennirr/soundlab-studio/blob/main/themes/themes.h"
    click Themes "https://github.com/djennirr/soundlab-studio/blob/main/themes/themes.cpp"
    click CMake "https://github.com/djennirr/soundlab-studio/blob/main/CMakeLists.txt"
    click Scripts "https://github.com/djennirr/soundlab-studio/blob/main/debug.sh"
    click Scripts "https://github.com/djennirr/soundlab-studio/blob/main/script.sh"
    click README "https://github.com/djennirr/soundlab-studio/blob/main/README.md"

    %% Styles
    classDef ui fill:#AED6F1,stroke:#1F618D,color:#1B2631;
    classDef control fill:#FCF3CF,stroke:#B7950B,color:#1B2631;
    classDef audio fill:#A9DFBF,stroke:#196F3D,color:#1B2631;
    classDef io fill:#F5CBA7,stroke:#A04000,color:#1B2631;
    classDef resource fill:#D7BDE2,stroke:#641E16,color:#1B2631;
    classDef build fill:#D5DBDB,stroke:#424949,color:#1B2631;
    classDef third fill:#E8DAEF,stroke:#5B2C6F,color:#1B2631;
```
