# alien-2301/oop-juce architecture

> Architecture diagram of the GitHub repository alien-2301/oop-juce, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/alien-2301/oop-juce
- Repository: https://github.com/alien-2301/oop-juce

## Overview

SynthwavePlayer is a JUCE desktop DJ application. Users add tracks to a shared library, load tracks onto either deck, and control playback, cues, and EQ while viewing waveforms and BPM; the two players feed a shared mixer. Cue and EQ settings persist per track, and the README also documents a persistent playlist library. The graph reflects the shown wiring and README capabilities; the playlist persistence implementation and some mixer details were not excerpted.

Main entry points: [`AudioProject/NewProject/Source/DeckGUI.cpp`](https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/DeckGUI.cpp) (Deck controls), [`AudioProject/NewProject/Source/MainComponent.cpp`](https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/MainComponent.cpp) (App coordinator), [`AudioProject/NewProject/Source/PlayListComponent.cpp`](https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/PlayListComponent.cpp) (Track library), [`AudioProject/NewProject/Source/DjAudioPlayer.cpp`](https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/DjAudioPlayer.cpp) (Deck audio player)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application UI"]
  node_startup["JUCE startup<br/>[Main.cpp]"]
  node_main["App coordinator<br/>[MainComponent.cpp]"]
  node_deck["Deck controls<br/>[DeckGUI.cpp]"]
  node_waveform["Waveform view"]
end

subgraph group_audio["Audio Engine"]
  node_player["Deck audio player<br/>[DjAudioPlayer.cpp]"]
  node_mixer["Shared mixer<br/>[MainComponent.cpp]"]
end

subgraph group_library["Track Library"]
  node_playlist["Track library"]
end

subgraph group_settings["Track Settings"]
  node_cues["Cue profiles<br/>[CueStorage.cpp]"]
  node_eq["EQ profiles<br/>[EQStorage.cpp]"]
end

node_user(("DJ user"))
node_disk[("Local profile files")]

node_user -->|"launches"| node_startup
node_startup -->|"creates"| node_main
node_user -->|"controls"| node_deck
node_user -->|"adds tracks"| node_playlist
node_main -->|"hosts decks"| node_deck
node_main -->|"mixes playback"| node_player
node_main -.->|"hosts library"| node_playlist
node_deck -->|"controls playback"| node_player
node_deck -->|"loads track"| node_waveform
node_deck -->|"loads and saves"| node_cues
node_deck -->|"loads and saves"| node_eq
node_playlist -.->|"loads tracks"| node_deck
node_playlist -.->|"persists library"| node_disk
node_cues -->|"applies cues"| node_player
node_eq -->|"applies EQ"| node_player
node_cues -->|"reads and writes"| node_disk
node_eq -->|"reads and writes"| node_disk

click node_startup "https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/Main.cpp"
click node_main "https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/MainComponent.cpp"
click node_deck "https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/DeckGUI.cpp"
click node_waveform "https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/WaveFormDisplay.cpp"
click node_playlist "https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/PlayListComponent.cpp"
click node_player "https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/DjAudioPlayer.cpp"
click node_mixer "https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/MainComponent.cpp"
click node_cues "https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/CueStorage.cpp"
click node_eq "https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/EQStorage.cpp"

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_startup,node_main,node_deck,node_waveform,node_user toneBlue
class node_player,node_mixer,node_disk toneAmber
class node_playlist toneMint
class node_cues,node_eq toneRose
```

## Components

### Application UI

- [JUCE startup](https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/Main.cpp): `AudioProject/NewProject/Source/Main.cpp`
- [App coordinator](https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/MainComponent.cpp): `AudioProject/NewProject/Source/MainComponent.cpp`
- [Deck controls](https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/DeckGUI.cpp): `AudioProject/NewProject/Source/DeckGUI.cpp`
- [Waveform view](https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/WaveFormDisplay.cpp): `AudioProject/NewProject/Source/WaveFormDisplay.cpp`

### Audio Engine

- [Deck audio player](https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/DjAudioPlayer.cpp): `AudioProject/NewProject/Source/DjAudioPlayer.cpp`
- [Shared mixer](https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/MainComponent.cpp): `AudioProject/NewProject/Source/MainComponent.cpp`

### Track Library

- [Track library](https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/PlayListComponent.cpp): `AudioProject/NewProject/Source/PlayListComponent.cpp`

### Track Settings

- [Cue profiles](https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/CueStorage.cpp): `AudioProject/NewProject/Source/CueStorage.cpp`
- [EQ profiles](https://github.com/alien-2301/oop-juce/blob/main/AudioProject/NewProject/Source/EQStorage.cpp): `AudioProject/NewProject/Source/EQStorage.cpp`

### Other components

- **DJ user**
- **Local profile files**

## Connections

- DJ user → JUCE startup: launches (evidence: `AudioProject/NewProject/Source/Main.cpp`)
- JUCE startup → App coordinator: creates (evidence: `AudioProject/NewProject/Source/Main.cpp`)
- DJ user → Deck controls: controls (evidence: `README.md`)
- DJ user → Track library: adds tracks (evidence: `README.md`)
- App coordinator → Deck controls: hosts decks (evidence: `README.md`)
- App coordinator → Deck audio player: mixes playback (evidence: `README.md`)
- App coordinator → Track library: hosts library
- Deck controls → Deck audio player: controls playback (evidence: `AudioProject/NewProject/Source/DeckGUI.cpp`)
- Deck controls → Waveform view: loads track (evidence: `AudioProject/NewProject/Source/DeckGUI.cpp`)
- Deck controls → Cue profiles: loads and saves (evidence: `AudioProject/NewProject/Source/DeckGUI.cpp`)
- Deck controls → EQ profiles: loads and saves (evidence: `AudioProject/NewProject/Source/DeckGUI.cpp`)
- Track library → Deck controls: loads tracks
- Track library → Local profile files: persists library
- Cue profiles → Deck audio player: applies cues (evidence: `AudioProject/NewProject/Source/CueStorage.cpp`)
- EQ profiles → Deck audio player: applies EQ (evidence: `AudioProject/NewProject/Source/EQStorage.cpp`)
- Cue profiles → Local profile files: reads and writes (evidence: `AudioProject/NewProject/Source/CueStorage.cpp`)
- EQ profiles → Local profile files: reads and writes (evidence: `AudioProject/NewProject/Source/EQStorage.cpp`)
