# asim-tahir/audio-channel-ext architecture

> Architecture diagram of the GitHub repository asim-tahir/audio-channel-ext, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-02-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/asim-tahir/audio-channel-ext
- Repository: https://github.com/asim-tahir/audio-channel-ext

## Overview

##### Project type and purpose
- This is a browser‐extension project (specifically a Chrome Extension) for audio channel equalization.
- Purpose: provide an in‐browser UI (popup + options page) allowing users to tweak audio parameters, apply convolution (IR) filters, and store settings.

##### File structure
Top-level components:
- manifest.json – extension metadata, permissions, entry points (popup.html, options.html, background scripts).
- _locales/… – translation files for UI text.
- js/
– bg/ (background scripts for audio engine: bg.js, jungle.js, tuna.js)
– popup/ (UI logic for the popup: modules.js, popup.js, sliders.js, ui.js, options.js)
– common.js (shared utilities)
- impulses/ (audio impulse response files used by convolution filters)
- popup.html, options.html – UI entry pages

##### README for additional insights
- Confirms it’s a “Graveyard repository” of an audio equalizer Chrome Extension.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Chrome Extension Host
    subgraph "Chrome Extension Host"
        Manifest["manifest.json"]:::shell
    end

    %% UI Layers
    subgraph "Popup UI"
        PopupHTML["popup.html"]:::ui
        PopupJS["popup.js"]:::ui
        UIJS["ui.js"]:::ui
        Sliders["sliders.js"]:::ui
        Modules["modules.js"]:::ui
        CSSPopup["style.css"]:::assets
    end

    subgraph "Options UI"
        OptionsHTML["options.html"]:::ui
        OptionsJS["options.js"]:::ui
    end

    %% Background Engine
    subgraph "Background Audio Engine"
        BGJS["bg.js"]:::backend
        Jungle["jungle.js"]:::backend
        Tuna["tuna.js"]:::backend
        subgraph "Audio Pipeline"
            AC["AudioContext"]:::backend
            Splitter["Splitter Node"]:::backend
            Convolver["Convolver Node"]:::backend
            Filters["Filter Nodes"]:::backend
            Merger["Merger Node"]:::backend
        end
        ImpulseFile["ir_rev_short.wav"]:::assets
    end

    %% Shared & External
    subgraph "Shared Modules & Localization"
        Common["js/common.js"]:::shared
        Locales["_locales/*/messages.json"]:::i18n
    end

    Storage["chrome.storage"]:::storage
    BrowserOut["Browser Audio Output"]:::external
    AssetsIcons["typicons.eot"]:::assets

    %% Connections
    Manifest --> PopupHTML
    Manifest --> OptionsHTML

    PopupHTML --> UIJS
    UIJS --> PopupJS
    PopupJS --> Sliders
    PopupJS --> Modules
    PopupJS -->|"loadSettings"| Storage
    OptionsJS -->|"loadSettings"| Storage
    BGJS -->|"loadSettings"| Storage

    PopupJS -->|"sendMessage"| BGJS
    BGJS -->|"onMessage"| PopupJS

    OptionsJS -->|"saveSettings"| Storage

    Locales --> PopupHTML
    Locales --> OptionsHTML

    CSSPopup --> PopupHTML
    AssetsIcons --> PopupHTML

    BGJS --> AC
    AC --> Splitter
    Splitter --> Convolver
    Convolver --> Filters
    Filters --> Merger
    Merger -->|"Audio Output"| BrowserOut

    ImpulseFile --> Convolver

    Common --> PopupJS
    Common --> OptionsJS
    Common --> BGJS

    %% Click Events
    click Manifest "https://github.com/asim-tahir/audio-channel-ext/blob/main/manifest.json"
    click PopupHTML "https://github.com/asim-tahir/audio-channel-ext/blob/main/popup.html"
    click PopupJS "https://github.com/asim-tahir/audio-channel-ext/blob/main/js/popup/popup.js"
    click UIJS "https://github.com/asim-tahir/audio-channel-ext/blob/main/js/popup/ui.js"
    click Sliders "https://github.com/asim-tahir/audio-channel-ext/blob/main/js/popup/sliders.js"
    click Modules "https://github.com/asim-tahir/audio-channel-ext/blob/main/js/popup/modules.js"
    click CSSPopup "https://github.com/asim-tahir/audio-channel-ext/blob/main/style/style.css"
    click OptionsHTML "https://github.com/asim-tahir/audio-channel-ext/blob/main/options.html"
    click OptionsJS "https://github.com/asim-tahir/audio-channel-ext/blob/main/js/popup/options.js"
    click BGJS "https://github.com/asim-tahir/audio-channel-ext/blob/main/js/bg/bg.js"
    click Jungle "https://github.com/asim-tahir/audio-channel-ext/blob/main/js/bg/jungle.js"
    click Tuna "https://github.com/asim-tahir/audio-channel-ext/blob/main/js/bg/tuna.js"
    click ImpulseFile "https://github.com/asim-tahir/audio-channel-ext/blob/main/impulses/ir_rev_short.wav"
    click Common "https://github.com/asim-tahir/audio-channel-ext/blob/main/js/common.js"
    click Locales "https://github.com/asim-tahir/audio-channel-ext/blob/main/_locales/*/messages.json"
    click AssetsIcons "https://github.com/asim-tahir/audio-channel-ext/blob/main/style/typicons.eot"

    %% Styles
    classDef shell fill:#f9f,stroke:#333,stroke-width:1px
    classDef ui fill:#bbf,stroke:#333,stroke-width:1px
    classDef backend fill:#bfb,stroke:#333,stroke-width:1px
    classDef storage fill:#ffb,stroke:#333,stroke-width:1px
    classDef i18n fill:#fbb,stroke:#333,stroke-width:1px
    classDef assets fill:#ddd,stroke:#333,stroke-width:1px
    classDef shared fill:#ffd,stroke:#333,stroke-width:1px
    classDef external fill:#eee,stroke:#333,stroke-width:1px
```
