# maddygoround/audioviz architecture

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

- Interactive diagram: https://gitdiagram.com/maddygoround/audioviz
- Repository: https://github.com/maddygoround/audioviz

## Overview

##### Main Components

A. Input Layer:
- Audio File Handler (supports MP3, WAV)
- Configuration Manager (for handling user parameters)

B. Core Processing Components:
- Audio Processor (PCM conversion)
- Probe Module (for audio analysis)
- Canvas Initializer
- Renderer System
- Pattern Generator

C. External Dependencies:
- FFmpeg/FFprobe
- Node.js Runtime
- headless-gl (for Linux systems)

**[Input Audio File] → [Configuration] → [Audio Processing Pipeline] → [Rendering Pipeline] → [Output Video]**

##### Detailed Component Relationships

A. Input Processing Flow:
**Audio File → FFprobe → PCM Conversion → Audio Analysis**

B. Rendering Pipeline:
**Canvas Init → Pattern Generation → Frame Drawing → Frame Combination**

##### Key Technical Elements to Highlight

- lib/pcm.js: Handles audio processing
- lib/probe.js: Manages audio analysis
- renderer/: Contains the visualization logic
- patterns.js: Implements various visualization patterns
- init-canvas.js: Handles canvas initialization

##### Implementation Details

How the following components interact:
- Pattern implementations (bars, curve, wave, roundBars, etc.)
- Canvas dimensions (width/height parameters)
- Wave positioning (top, right, left, bottom)

**Top Level:**
**[Input] → [Processing] → [Output]**

**Detailed Level:**
**[Audio Input] → [FFmpeg] → [PCM Conversion] → [Pattern Generation] → [Frame Rendering] → [Video Output]**
- ↑
- [Configuration Parameters]

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Legend
        L1[Component]
        L2([External Dependency])
        L3[/"Input/Output"/]
        L4{{Configuration}}
    end

    subgraph "Input Layer"
        AudioInput[/"Audio Input\n(MP3, WAV)"/]:::io
        Config{{Configuration Parameters}}:::config
    end

    subgraph "External Dependencies"
        FFmpeg([FFmpeg]):::external
        FFprobe([FFprobe]):::external
        HeadlessGL([headless-gl]):::external
        NodeRuntime([Node.js Runtime]):::external
    end

    subgraph "Core Processing"
        ProbeModule["Probe Module\n(Audio Analysis)"]:::core
        AudioProcessor["Audio Processor\n(PCM Conversion)"]:::core
        CanvasInit["Canvas Initializer"]:::core
        PatternGen["Pattern Generator"]:::core
        FrameDraw["Frame Drawing System"]:::core
        FrameCombine["Frame Combination System"]:::core
    end

    subgraph "Output Layer"
        VideoOutput[/"Output Video"/]:::io
    end

    AudioInput --> ProbeModule
    AudioInput --> AudioProcessor
    Config --> AudioProcessor
    Config --> PatternGen
    Config --> CanvasInit

    ProbeModule --> AudioProcessor
    AudioProcessor --> PatternGen
    CanvasInit --> PatternGen
    PatternGen --> FrameDraw
    FrameDraw --> FrameCombine
    FrameCombine --> VideoOutput

    FFmpeg --> AudioProcessor
    FFprobe --> ProbeModule
    HeadlessGL --> CanvasInit
    NodeRuntime --> AudioProcessor

    %% Click Events
    click AudioProcessor "https://github.com/maddygoround/audioviz/blob/main/lib/pcm.js"
    click ProbeModule "https://github.com/maddygoround/audioviz/blob/main/lib/probe.js"
    click CanvasInit "https://github.com/maddygoround/audioviz/blob/main/init-canvas.js"
    click PatternGen "https://github.com/maddygoround/audioviz/blob/main/renderer/patterns.js"
    click FrameDraw "https://github.com/maddygoround/audioviz/blob/main/renderer/draw-frames.js"
    click FrameCombine "https://github.com/maddygoround/audioviz/blob/main/renderer/combine-frames.js"

    %% Styles
    classDef io fill:#3498db,stroke:#2980b9,color:white
    classDef core fill:#2ecc71,stroke:#27ae60,color:white
    classDef external fill:#f1c40f,stroke:#f39c12,color:black
    classDef config fill:#95a5a6,stroke:#7f8c8d,color:white
```
