# periyannan35/perit architecture

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

- Interactive diagram: https://gitdiagram.com/periyannan35/perit
- Repository: https://github.com/periyannan35/perit

## Overview

This repository provides a limited, offline browser demo of audio enhancement; the full Android app is not included. The main workflow is to open the demo, load audio, adjust playback and enhancement settings, and listen or export a WAV. The graph covers the controller, playlist, DSP engine, visualization, and settings. Sampled excerpts show some connections; omitted portions of app.js and audio-engine.js limit detail on file loading and control wiring.

Main entry points: [`app.js`](https://github.com/periyannan35/perit/blob/master/app.js) (App controller), [`audio-engine.js`](https://github.com/periyannan35/perit/blob/master/audio-engine.js) (Audio engine), [`index.html`](https://github.com/periyannan35/perit/blob/master/index.html) (Browser demo), [`visualizer.js`](https://github.com/periyannan35/perit/blob/master/visualizer.js) (Audio visualizer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Demo interaction"]
  node_demo["Browser demo<br/>[index.html]"]
  node_controller["App controller<br/>[app.js]"]
  node_playlist["Playlist manager<br/>[app.js]"]
  node_settings[("Saved settings<br/>[app.js]")]
end

subgraph group_processing["Audio processing"]
  node_engine["Audio engine<br/>[audio-engine.js]"]
  node_dsp["Live DSP chain<br/>[audio-engine.js]"]
  node_export["WAV export<br/>[audio-engine.js]"]
end

subgraph group_presentation["Visualization"]
  node_visualizer["Audio visualizer<br/>[visualizer.js]"]
end

node_user(("Listener"))

node_user -->|"opens and uploads"| node_demo
node_demo -.->|"hosts demo"| node_controller
node_controller -->|"creates and uses"| node_playlist
node_controller -->|"creates and controls"| node_engine
node_controller -->|"creates and starts"| node_visualizer
node_visualizer -->|"reads analyser data"| node_engine
node_engine -->|"builds and feeds"| node_dsp
node_controller -->|"reads and saves"| node_settings
node_engine -->|"renders processed audio"| node_export

click node_demo "https://github.com/periyannan35/perit/blob/master/index.html"
click node_controller "https://github.com/periyannan35/perit/blob/master/app.js"
click node_playlist "https://github.com/periyannan35/perit/blob/master/app.js"
click node_settings "https://github.com/periyannan35/perit/blob/master/app.js"
click node_engine "https://github.com/periyannan35/perit/blob/master/audio-engine.js"
click node_dsp "https://github.com/periyannan35/perit/blob/master/audio-engine.js"
click node_export "https://github.com/periyannan35/perit/blob/master/audio-engine.js"
click node_visualizer "https://github.com/periyannan35/perit/blob/master/visualizer.js"

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_demo,node_controller,node_playlist,node_settings toneBlue
class node_engine,node_dsp,node_export toneAmber
class node_visualizer toneMint
class node_user toneIndigo
```

## Components

### Demo interaction

- [Browser demo](https://github.com/periyannan35/perit/blob/master/index.html): `index.html`
- [App controller](https://github.com/periyannan35/perit/blob/master/app.js): `app.js`
- [Playlist manager](https://github.com/periyannan35/perit/blob/master/app.js): `app.js`
- [Saved settings](https://github.com/periyannan35/perit/blob/master/app.js): `app.js`

### Audio processing

- [Audio engine](https://github.com/periyannan35/perit/blob/master/audio-engine.js): `audio-engine.js`
- [Live DSP chain](https://github.com/periyannan35/perit/blob/master/audio-engine.js): `audio-engine.js`
- [WAV export](https://github.com/periyannan35/perit/blob/master/audio-engine.js): `audio-engine.js`

### Visualization

- [Audio visualizer](https://github.com/periyannan35/perit/blob/master/visualizer.js): `visualizer.js`

### Other components

- **Listener**

## Connections

- Listener → Browser demo: opens and uploads (evidence: `README.md`)
- Browser demo → App controller: hosts demo
- App controller → Playlist manager: creates and uses (evidence: `app.js`)
- App controller → Audio engine: creates and controls (evidence: `app.js`)
- App controller → Audio visualizer: creates and starts (evidence: `app.js`)
- Audio visualizer → Audio engine: reads analyser data (evidence: `visualizer.js`)
- Audio engine → Live DSP chain: builds and feeds (evidence: `audio-engine.js`)
- App controller → Saved settings: reads and saves (evidence: `app.js`)
- Audio engine → WAV export: renders processed audio (evidence: `audio-engine.js`)
