# beanbean9339/between-signals architecture

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

- Interactive diagram: https://gitdiagram.com/beanbean9339/between-signals
- Repository: https://github.com/beanbean9339/between-signals

## Overview

Between Signals is an interactive installation that connects two environments through visitor movement and speech, routing events between rooms and sending them to TouchDesigner for real-time presentation. The graph emphasizes the documented room-aware workflow, plus the legacy OSC server and simulation runners. Camera and depth-processing modules are included as core capabilities, but their connection to room event handling is not demonstrated in the excerpts. The README gives only a brief product description, so some subsystem details rely on source excerpts and the source index.

Main entry points: [`what-the-ocean-remembers/backend/room.py`](https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/room.py) (Room State), [`what-the-ocean-remembers/backend/communication_refactored.py`](https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/communication_refactored.py) (Event Router), [`what-the-ocean-remembers/backend/config_loader.py`](https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/config_loader.py) (Room Configuration), [`what-the-ocean-remembers/backend/simulation_integration.py`](https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/simulation_integration.py) (Room Simulation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sensing["Visitor Sensing"]
  node_camera["Orbbec Cameras<br/>[orbbec_camera.py]"]
  node_depth["Depth Processing<br/>[depth_processor.py]"]
  node_speech["Speech Recognition"]
  node_speech_room["Speech Integration"]
end

subgraph group_events["Events and Routing"]
  node_config["Room Configuration<br/>[config_loader.py]"]
  node_event_schema["Event Schema<br/>[events.py]"]
  node_room["Room State<br/>[room.py]"]
  node_router["Event Router"]
  node_backend_server["OSC Communication Server"]
  node_legacy_entry["Legacy Server Entry<br/>[main.py]"]
  node_legacy_osc["Legacy OSC Router<br/>[communication.py]"]
end

subgraph group_presentation["Environment Presentation"]
  node_touchdesigner["TouchDesigner Environments"]
  node_room_a["Environment A<br/>[room_a.json]"]
  node_room_b["Environment B<br/>[room_b.json]"]
end

subgraph group_simulation["Simulation"]
  node_sim_runner["Event Simulators<br/>[simulation.py]"]
  node_sim_integration["Room Simulation"]
  node_td_sim["TouchDesigner Simulation"]
end

node_visitor(("Visitor"))

node_visitor -.->|"moves before"| node_camera
node_visitor -.->|"speaks to"| node_speech
node_camera -->|"supplies frames"| node_depth
node_speech -->|"emits transcripts"| node_speech_room
node_speech_room -->|"emits events"| node_room
node_room -->|"routes events"| node_router
node_router -->|"dispatches events"| node_room
node_room -->|"sends OSC"| node_touchdesigner
node_config -->|"configures"| node_room
node_legacy_entry -->|"starts server"| node_legacy_osc
node_legacy_osc -->|"sends OSC"| node_touchdesigner
node_sim_integration -->|"runs patterns"| node_sim_runner
node_sim_integration -->|"emits events"| node_room
node_td_sim -->|"delivers events"| node_room
node_event_schema -.->|"defines payloads"| node_router
node_backend_server -.->|"accepts OSC events"| node_router
node_room_a -.->|"provides settings"| node_config
node_room_b -.->|"provides settings"| node_config

click node_camera "https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/orbbec_camera.py"
click node_depth "https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/depth_processor.py"
click node_speech "https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/speech_refactored.py"
click node_speech_room "https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/speech_integration.py"
click node_config "https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/config_loader.py"
click node_event_schema "https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/events.py"
click node_room "https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/room.py"
click node_router "https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/communication_refactored.py"
click node_backend_server "https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/communication_refactored.py"
click node_legacy_entry "https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/main.py"
click node_legacy_osc "https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/communication.py"
click node_touchdesigner "https://github.com/beanbean9339/between-signals/tree/main/what-the-ocean-remembers/touchdesigner"
click node_sim_runner "https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/simulation.py"
click node_sim_integration "https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/simulation_integration.py"
click node_td_sim "https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/touchdesigner_simulation.py"
click node_room_a "https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/config/room_a.json"
click node_room_b "https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/config/room_b.json"

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_camera,node_depth,node_speech,node_speech_room toneBlue
class node_config,node_event_schema,node_room,node_router,node_backend_server,node_legacy_entry,node_legacy_osc toneAmber
class node_touchdesigner,node_room_a,node_room_b toneMint
class node_sim_runner,node_sim_integration,node_td_sim toneRose
class node_visitor toneIndigo
```

## Components

### Visitor Sensing

- [Orbbec Cameras](https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/orbbec_camera.py): `what-the-ocean-remembers/backend/orbbec_camera.py`
- [Depth Processing](https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/depth_processor.py): `what-the-ocean-remembers/backend/depth_processor.py`
- [Speech Recognition](https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/speech_refactored.py): `what-the-ocean-remembers/backend/speech_refactored.py`
- [Speech Integration](https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/speech_integration.py): `what-the-ocean-remembers/backend/speech_integration.py`

### Events and Routing

- [Room Configuration](https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/config_loader.py): `what-the-ocean-remembers/backend/config_loader.py`
- [Event Schema](https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/events.py): `what-the-ocean-remembers/backend/events.py`
- [Room State](https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/room.py): `what-the-ocean-remembers/backend/room.py`
- [Event Router](https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/communication_refactored.py): `what-the-ocean-remembers/backend/communication_refactored.py`
- [OSC Communication Server](https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/communication_refactored.py): `what-the-ocean-remembers/backend/communication_refactored.py`
- [Legacy Server Entry](https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/main.py): `what-the-ocean-remembers/backend/main.py`
- [Legacy OSC Router](https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/communication.py): `what-the-ocean-remembers/backend/communication.py`

### Environment Presentation

- [TouchDesigner Environments](https://github.com/beanbean9339/between-signals/tree/main/what-the-ocean-remembers/touchdesigner): `what-the-ocean-remembers/touchdesigner`
- [Environment A](https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/config/room_a.json): `what-the-ocean-remembers/config/room_a.json`
- [Environment B](https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/config/room_b.json): `what-the-ocean-remembers/config/room_b.json`

### Simulation

- [Event Simulators](https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/simulation.py): `what-the-ocean-remembers/backend/simulation.py`
- [Room Simulation](https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/simulation_integration.py): `what-the-ocean-remembers/backend/simulation_integration.py`
- [TouchDesigner Simulation](https://github.com/beanbean9339/between-signals/blob/main/what-the-ocean-remembers/backend/touchdesigner_simulation.py): `what-the-ocean-remembers/backend/touchdesigner_simulation.py`

### Other components

- **Visitor**

## Connections

- Visitor → Orbbec Cameras: moves before
- Visitor → Speech Recognition: speaks to
- Orbbec Cameras → Depth Processing: supplies frames (evidence: `what-the-ocean-remembers/backend/depth_processor.py`)
- Speech Recognition → Speech Integration: emits transcripts (evidence: `what-the-ocean-remembers/backend/speech_integration.py`)
- Speech Integration → Room State: emits events (evidence: `what-the-ocean-remembers/backend/speech_integration.py`)
- Room State → Event Router: routes events (evidence: `what-the-ocean-remembers/backend/room.py`)
- Event Router → Room State: dispatches events (evidence: `what-the-ocean-remembers/backend/communication_refactored.py`)
- Room State → TouchDesigner Environments: sends OSC (evidence: `what-the-ocean-remembers/backend/room.py`)
- Room Configuration → Room State: configures (evidence: `what-the-ocean-remembers/backend/room.py`)
- Legacy Server Entry → Legacy OSC Router: starts server (evidence: `what-the-ocean-remembers/backend/main.py`)
- Legacy OSC Router → TouchDesigner Environments: sends OSC (evidence: `what-the-ocean-remembers/backend/communication.py`)
- Room Simulation → Event Simulators: runs patterns (evidence: `what-the-ocean-remembers/backend/simulation_integration.py`)
- Room Simulation → Room State: emits events (evidence: `what-the-ocean-remembers/backend/simulation_integration.py`)
- TouchDesigner Simulation → Room State: delivers events (evidence: `what-the-ocean-remembers/backend/touchdesigner_simulation.py`)
- Event Schema → Event Router: defines payloads (evidence: `what-the-ocean-remembers/backend/communication_refactored.py`)
- OSC Communication Server → Event Router: accepts OSC events (evidence: `what-the-ocean-remembers/backend/communication_refactored.py`)
- Environment A → Room Configuration: provides settings
- Environment B → Room Configuration: provides settings
