# tech-multiverse/audio-reactive-dmx architecture

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

- Interactive diagram: https://gitdiagram.com/tech-multiverse/audio-reactive-dmx
- Repository: https://github.com/tech-multiverse/audio-reactive-dmx

## Overview

This repository documents an audio-reactive DMX lighting project: audio input is converted to DMX in TouchDesigner, then received by an Unreal Engine 5 scene to drive moving-head lights; the project also targets physical lighting. The supplied tree contains only bundled Python dependencies under the UE project’s Intermediate directory, not the TouchDesigner or Unreal runtime implementation. Accordingly, the graph preserves the README-described workflow and capabilities, but does not infer internal processing stages or unverified connections.

Main entry points: [`Audio_Reactive_DMX_UE5_project`](https://github.com/tech-multiverse/audio-reactive-dmx/tree/main/Audio_Reactive_DMX_UE5_project) (UE5 lighting scene)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_audio["Audio Input"]
  node_audio_source["Audio input"]
end

subgraph group_dmx["DMX Control"]
  node_touchdesigner["TouchDesigner project"]
  node_localhost(("Localhost DMX"))
end

subgraph group_lighting["Lighting Output"]
  node_ue_project["UE5 lighting scene"]
  node_moving_heads["Virtual moving heads"]
  node_physical_lights["Physical lights"]
end

node_dj(("DJ controller"))

node_dj -->|"provides audio"| node_audio_source
node_audio_source -->|"audio input"| node_touchdesigner
node_touchdesigner -->|"sends DMX"| node_localhost
node_localhost -->|"DMX input"| node_ue_project
node_ue_project -->|"drives lights"| node_moving_heads
node_touchdesigner -.->|"controls lighting"| node_physical_lights

click node_ue_project "https://github.com/tech-multiverse/audio-reactive-dmx/tree/main/Audio_Reactive_DMX_UE5_project"
click node_moving_heads "https://github.com/tech-multiverse/audio-reactive-dmx/tree/main/Audio_Reactive_DMX_UE5_project"

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_audio_source toneBlue
class node_touchdesigner,node_localhost toneAmber
class node_ue_project,node_moving_heads,node_physical_lights toneMint
class node_dj toneIndigo
```

## Components

### Audio Input

- **Audio input**

### DMX Control

- **TouchDesigner project**
- **Localhost DMX**

### Lighting Output

- [UE5 lighting scene](https://github.com/tech-multiverse/audio-reactive-dmx/tree/main/Audio_Reactive_DMX_UE5_project): `Audio_Reactive_DMX_UE5_project`
- [Virtual moving heads](https://github.com/tech-multiverse/audio-reactive-dmx/tree/main/Audio_Reactive_DMX_UE5_project): `Audio_Reactive_DMX_UE5_project`
- **Physical lights**

### Other components

- **DJ controller**

## Connections

- DJ controller → Audio input: provides audio
- Audio input → TouchDesigner project: audio input
- TouchDesigner project → Localhost DMX: sends DMX
- Localhost DMX → UE5 lighting scene: DMX input
- UE5 lighting scene → Virtual moving heads: drives lights
- TouchDesigner project → Physical lights: controls lighting
