# bozbez/win-capture-audio architecture

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

- Interactive diagram: https://gitdiagram.com/bozbez/win-capture-audio
- Repository: https://github.com/bozbez/win-capture-audio

## Overview

##### Main Components

a) Core Components:
- Audio Capture System
- Session Monitor
- Audio Mixer
- Localization System
- Plugin Interface

b) External Dependencies:
- OBS Studio
- Windows Audio API
- Process Management

**[OBS Studio Integration Layer]**
- ↕
**[Plugin Core Layer]**
- ↕
**[Windows System Layer]**

##### Component Relationships

a) OBS Integration Layer:
- Plugin.cpp as the main entry point
- To OBS Studio's plugin API
- Format conversion interface

b) Plugin Core Layer:
- Audio Capture Helper Manager
- Session Monitor (for process tracking)
- Mixer (for audio processing)
- Audio Capture implementation

c) Windows System Layer:
- ActivateAudioInterfaceAsync API
- Process Loopback Audio
- Windows Audio Session

##### Specific Implementation Details

- Rectangles: Core components
- Rounded rectangles: External interfaces
- Hexagons: System APIs

- Blue: OBS-related components
- Green: Audio processing components
- Yellow: Windows API interfaces
- Gray: Support systems

##### Important Elements to Highlight

- Audio capture flow from target application
- Process monitoring and session management
- Audio mixing and processing pipeline
- Plugin initialization and shutdown sequences

Create distinct sections for:
a) Configuration and Setup
b) Runtime Audio Processing
c) Session Management
d) Internationalization Support

Key Files to Reference:
- src/audio-capture.cpp/hpp (core audio capture)
- src/session-monitor.cpp/hpp (process monitoring)
- src/mixer.cpp/hpp (audio processing)
- src/plugin.cpp (OBS integration)

## Diagram (Mermaid)

```mermaid
graph TB
    %% Style definitions
    classDef obs fill:#3498db,stroke:#2980b9,color:white
    classDef audio fill:#2ecc71,stroke:#27ae60,color:white
    classDef windows fill:#f1c40f,stroke:#f39c12,color:black
    classDef support fill:#95a5a6,stroke:#7f8c8d,color:white
    
    subgraph OBS_Layer["OBS Studio Integration Layer"]
        Plugin["Plugin Interface"]
        FormatConv["Format Conversion"]
    end

    subgraph Core_Layer["Plugin Core Layer"]
        AudioCapture["Audio Capture System"]
        SessionMon["Session Monitor"]
        Mixer["Audio Mixer"]
        LocaleSystem["Localization System"]
        Common["Common Utilities"]
    end

    subgraph Windows_Layer["Windows System Layer"]
        WinAudio["Windows Audio API"]
        ProcessMgmt["Process Management"]
        AudioSession["Audio Session Interface"]
    end

    %% Connections
    Plugin --> AudioCapture
    Plugin --> SessionMon
    AudioCapture --> Mixer
    SessionMon --> ProcessMgmt
    AudioCapture --> WinAudio
    Mixer --> AudioSession
    FormatConv --> Mixer
    SessionMon --> AudioSession
    Common --> AudioCapture
    Common --> SessionMon
    Common --> Mixer

    %% Click events
    click Plugin "https://github.com/bozbez/win-capture-audio/blob/main/src/plugin.cpp"
    click AudioCapture "https://github.com/bozbez/win-capture-audio/blob/main/src/audio-capture.cpp"
    click SessionMon "https://github.com/bozbez/win-capture-audio/blob/main/src/session-monitor.cpp"
    click Mixer "https://github.com/bozbez/win-capture-audio/blob/main/src/mixer.cpp"
    click FormatConv "https://github.com/bozbez/win-capture-audio/blob/main/src/format-conversion.hpp"
    click LocaleSystem "https://github.com/bozbez/win-capture-audio/tree/main/data/locale"
    click Common "https://github.com/bozbez/win-capture-audio/blob/main/src/common.hpp"

    %% Style assignments
    class Plugin,FormatConv obs
    class AudioCapture,Mixer,SessionMon audio
    class WinAudio,ProcessMgmt,AudioSession windows
    class LocaleSystem,Common support

    %% Legend
    subgraph Legend
        ObsComp["OBS Components"]:::obs
        AudioComp["Audio Components"]:::audio
        WinComp["Windows Components"]:::windows
        SupportComp["Support Systems"]:::support
    end
```
