# deveduardoiensen/kordixx architecture

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

- Interactive diagram: https://gitdiagram.com/deveduardoiensen/kordixx
- Repository: https://github.com/deveduardoiensen/kordixx

## Overview

Kordix is documented as a real-time audio copilot for analog and hybrid mixers. The intended workflow is to capture master/PFL audio, analyze it, and present practical guidance to an operator through a HUD and spoken alerts; musicians can also connect through the Stage App. The README describes these capabilities and a three-thread architecture, but the supplied tree contains no runtime source, so this is a documented product map, not a verified call graph. Roadmap details are represented only where named in the README.

Main entry points: [`README.md`](https://github.com/deveduardoiensen/kordixx/blob/main/README.md) (DSP analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_audio["Audio analysis"]
  node_capture["Audio capture<br/>[README.md]"]
  node_dsp["DSP analysis<br/>[README.md]"]
  node_collision["Collision radar<br/>[README.md]"]
end

subgraph group_guidance["Operator guidance"]
  node_telemetry["HUD telemetry<br/>[README.md]"]
  node_copilot["Audio copilot<br/>[README.md]"]
  node_voice["J.A.R.V.I.S. voice<br/>[README.md]"]
end

subgraph group_calibration["Calibration tools"]
  node_calibration["Calibration wizard<br/>[README.md]"]
  node_cable["Cable diagnosis<br/>[README.md]"]
  node_gain["Safe gain setup<br/>[README.md]"]
  node_tuner["YIN tuner<br/>[README.md]"]
  node_soundcheck["Virtual soundcheck<br/>[README.md]"]
end

subgraph group_ecosystem["Stage ecosystem"]
  node_audit["PDF audit<br/>[README.md]"]
  node_stageapp["Stage App<br/>[README.md]"]
end

node_operator(("Audio operator"))
node_mixer["Mixer signal"]
node_musician(("Stage musician"))
node_wifi["Local Wi-Fi"]

node_mixer -->|"supplies signal"| node_capture
node_capture -->|"feeds analysis"| node_dsp
node_dsp -->|"sends metrics"| node_telemetry
node_dsp -->|"informs analysis"| node_copilot
node_copilot -->|"speaks alerts"| node_voice
node_telemetry -->|"shows status"| node_operator
node_voice -->|"speaks guidance"| node_operator
node_copilot -->|"detects masking"| node_collision
node_operator -->|"runs setup"| node_calibration
node_calibration -->|"checks noise"| node_cable
node_calibration -->|"sets safe gain"| node_gain
node_operator -->|"uses tuner"| node_tuner
node_operator -->|"runs check"| node_soundcheck
node_operator -->|"requests report"| node_audit
node_musician -->|"connects through"| node_wifi
node_wifi -->|"provides access"| node_stageapp
node_stageapp -->|"connects musicians"| node_operator

click node_capture "https://github.com/deveduardoiensen/kordixx/blob/main/README.md"
click node_dsp "https://github.com/deveduardoiensen/kordixx/blob/main/README.md"
click node_telemetry "https://github.com/deveduardoiensen/kordixx/blob/main/README.md"
click node_copilot "https://github.com/deveduardoiensen/kordixx/blob/main/README.md"
click node_voice "https://github.com/deveduardoiensen/kordixx/blob/main/README.md"
click node_calibration "https://github.com/deveduardoiensen/kordixx/blob/main/README.md"
click node_cable "https://github.com/deveduardoiensen/kordixx/blob/main/README.md"
click node_gain "https://github.com/deveduardoiensen/kordixx/blob/main/README.md"
click node_tuner "https://github.com/deveduardoiensen/kordixx/blob/main/README.md"
click node_soundcheck "https://github.com/deveduardoiensen/kordixx/blob/main/README.md"
click node_collision "https://github.com/deveduardoiensen/kordixx/blob/main/README.md"
click node_audit "https://github.com/deveduardoiensen/kordixx/blob/main/README.md"
click node_stageapp "https://github.com/deveduardoiensen/kordixx/blob/main/README.md"

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_capture,node_dsp,node_collision toneBlue
class node_telemetry,node_copilot,node_voice toneAmber
class node_calibration,node_cable,node_gain,node_tuner,node_soundcheck toneMint
class node_audit,node_stageapp toneRose
class node_operator,node_mixer,node_musician,node_wifi toneIndigo
```

## Components

### Audio analysis

- [Audio capture](https://github.com/deveduardoiensen/kordixx/blob/main/README.md): `README.md`
- [DSP analysis](https://github.com/deveduardoiensen/kordixx/blob/main/README.md): `README.md`
- [Collision radar](https://github.com/deveduardoiensen/kordixx/blob/main/README.md): `README.md`

### Operator guidance

- [HUD telemetry](https://github.com/deveduardoiensen/kordixx/blob/main/README.md): `README.md`
- [Audio copilot](https://github.com/deveduardoiensen/kordixx/blob/main/README.md): `README.md`
- [J.A.R.V.I.S. voice](https://github.com/deveduardoiensen/kordixx/blob/main/README.md): `README.md`

### Calibration tools

- [Calibration wizard](https://github.com/deveduardoiensen/kordixx/blob/main/README.md): `README.md`
- [Cable diagnosis](https://github.com/deveduardoiensen/kordixx/blob/main/README.md): `README.md`
- [Safe gain setup](https://github.com/deveduardoiensen/kordixx/blob/main/README.md): `README.md`
- [YIN tuner](https://github.com/deveduardoiensen/kordixx/blob/main/README.md): `README.md`
- [Virtual soundcheck](https://github.com/deveduardoiensen/kordixx/blob/main/README.md): `README.md`

### Stage ecosystem

- [PDF audit](https://github.com/deveduardoiensen/kordixx/blob/main/README.md): `README.md`
- [Stage App](https://github.com/deveduardoiensen/kordixx/blob/main/README.md): `README.md`

### Other components

- **Audio operator**
- **Mixer signal**
- **Stage musician**
- **Local Wi-Fi**

## Connections

- Mixer signal → Audio capture: supplies signal
- Audio capture → DSP analysis: feeds analysis
- DSP analysis → HUD telemetry: sends metrics
- DSP analysis → Audio copilot: informs analysis
- Audio copilot → J.A.R.V.I.S. voice: speaks alerts
- HUD telemetry → Audio operator: shows status
- J.A.R.V.I.S. voice → Audio operator: speaks guidance
- Audio copilot → Collision radar: detects masking
- Audio operator → Calibration wizard: runs setup
- Calibration wizard → Cable diagnosis: checks noise
- Calibration wizard → Safe gain setup: sets safe gain
- Audio operator → YIN tuner: uses tuner
- Audio operator → Virtual soundcheck: runs check
- Audio operator → PDF audit: requests report
- Stage musician → Local Wi-Fi: connects through
- Local Wi-Fi → Stage App: provides access
- Stage App → Audio operator: connects musicians