# dmz34705/dmz-termvis architecture

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

- Interactive diagram: https://gitdiagram.com/dmz34705/dmz-termvis
- Repository: https://github.com/dmz34705/dmz-termvis

## Overview

DMZ TermVis captures live audio and turns it into configurable terminal visuals. The main path is user controls → program setup → platform capture → audio buffers and analysis → selected visualization → terminal output, with settings persisted between runs. README-documented modes and themes are represented within the rendering and configuration subsystems; the single C# source file is only partially excerpted, so connections not shown there are omitted rather than inferred.

Main entry points: [`termvis.cs`](https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs) (Visualizer runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime and controls"]
  node_program["Program entry<br/>[termvis.cs]"]
  node_viz["Visualizer runtime<br/>[termvis.cs]"]
  node_controls["Keyboard controls<br/>[termvis.cs]"]
end

subgraph group_audio["Audio input"]
  node_capture["Audio capture selection<br/>[termvis.cs]"]
  node_win_capture["Windows capture<br/>[termvis.cs]"]
  node_mac_capture["macOS capture<br/>[termvis.cs]"]
  node_rings["Audio rings<br/>[termvis.cs]"]
  node_analysis["Signal analysis<br/>[termvis.cs]"]
end

subgraph group_visual["Visualization and display"]
  node_bar_mode["Bars and mirror<br/>[termvis.cs]"]
  node_wave_mode["Wave and waterfall<br/>[termvis.cs]"]
  node_rain_code["Rain and code<br/>[termvis.cs]"]
  node_radial_mode["Radial mode<br/>[termvis.cs]"]
  node_scope_mode["XY scope<br/>[termvis.cs]"]
  node_screen["Terminal screen<br/>[termvis.cs]"]
end

subgraph group_settings["Settings"]
  node_settings_panel["Settings panel<br/>[termvis.cs]"]
  node_settings_store[("Saved settings<br/>[termvis.cs]")]
end

node_user(("User"))
node_audio_device(("Audio device"))
node_terminal(("Terminal"))

node_user -->|"launches"| node_program
node_program -->|"creates and loads"| node_viz
node_viz -->|"selects source"| node_capture
node_capture -->|"uses on Windows"| node_win_capture
node_capture -->|"uses on macOS"| node_mac_capture
node_audio_device -.->|"provides audio"| node_win_capture
node_audio_device -.->|"provides input"| node_mac_capture
node_win_capture -.->|"writes samples"| node_rings
node_mac_capture -.->|"writes samples"| node_rings
node_viz -->|"owns buffers"| node_rings
node_viz -.->|"analyzes audio"| node_analysis
node_viz -.->|"renders mode"| node_bar_mode
node_viz -.->|"renders mode"| node_wave_mode
node_viz -.->|"renders mode"| node_rain_code
node_viz -.->|"renders mode"| node_radial_mode
node_viz -.->|"renders mode"| node_scope_mode
node_viz -.->|"handles input"| node_controls
node_controls -.->|"opens panel"| node_settings_panel
node_settings_panel -.->|"loads and saves"| node_settings_store
node_viz -.->|"draws output"| node_screen
node_screen -.->|"displays frames"| node_terminal

click node_program "https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs"
click node_viz "https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs"
click node_controls "https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs"
click node_capture "https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs"
click node_win_capture "https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs"
click node_mac_capture "https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs"
click node_rings "https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs"
click node_analysis "https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs"
click node_bar_mode "https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs"
click node_wave_mode "https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs"
click node_rain_code "https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs"
click node_radial_mode "https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs"
click node_scope_mode "https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs"
click node_screen "https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs"
click node_settings_panel "https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs"
click node_settings_store "https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs"

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_program,node_viz,node_controls,node_user toneBlue
class node_capture,node_win_capture,node_mac_capture,node_rings,node_analysis toneAmber
class node_bar_mode,node_wave_mode,node_rain_code,node_radial_mode,node_scope_mode,node_screen toneMint
class node_settings_panel,node_settings_store toneRose
class node_audio_device,node_terminal toneIndigo
```

## Components

### Runtime and controls

- [Program entry](https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs): `termvis.cs`
- [Visualizer runtime](https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs): `termvis.cs`
- [Keyboard controls](https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs): `termvis.cs`

### Audio input

- [Audio capture selection](https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs): `termvis.cs`
- [Windows capture](https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs): `termvis.cs`
- [macOS capture](https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs): `termvis.cs`
- [Audio rings](https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs): `termvis.cs`
- [Signal analysis](https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs): `termvis.cs`

### Visualization and display

- [Bars and mirror](https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs): `termvis.cs`
- [Wave and waterfall](https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs): `termvis.cs`
- [Rain and code](https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs): `termvis.cs`
- [Radial mode](https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs): `termvis.cs`
- [XY scope](https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs): `termvis.cs`
- [Terminal screen](https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs): `termvis.cs`

### Settings

- [Settings panel](https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs): `termvis.cs`
- [Saved settings](https://github.com/dmz34705/dmz-termvis/blob/main/termvis.cs): `termvis.cs`

### Other components

- **User**
- **Audio device**
- **Terminal**

## Connections

- User → Program entry: launches (evidence: `README.md`)
- Program entry → Visualizer runtime: creates and loads (evidence: `termvis.cs`)
- Visualizer runtime → Audio capture selection: selects source (evidence: `termvis.cs`)
- Audio capture selection → Windows capture: uses on Windows (evidence: `termvis.cs`)
- Audio capture selection → macOS capture: uses on macOS (evidence: `termvis.cs`)
- Audio device → Windows capture: provides audio
- Audio device → macOS capture: provides input
- Windows capture → Audio rings: writes samples (evidence: `termvis.cs`)
- macOS capture → Audio rings: writes samples (evidence: `termvis.cs`)
- Visualizer runtime → Audio rings: owns buffers (evidence: `termvis.cs`)
- Visualizer runtime → Signal analysis: analyzes audio (evidence: `termvis.cs`)
- Visualizer runtime → Bars and mirror: renders mode (evidence: `termvis.cs`)
- Visualizer runtime → Wave and waterfall: renders mode (evidence: `termvis.cs`)
- Visualizer runtime → Rain and code: renders mode (evidence: `termvis.cs`)
- Visualizer runtime → Radial mode: renders mode (evidence: `termvis.cs`)
- Visualizer runtime → XY scope: renders mode (evidence: `termvis.cs`)
- Visualizer runtime → Keyboard controls: handles input (evidence: `termvis.cs`)
- Keyboard controls → Settings panel: opens panel (evidence: `termvis.cs`)
- Settings panel → Saved settings: loads and saves (evidence: `termvis.cs`)
- Visualizer runtime → Terminal screen: draws output (evidence: `termvis.cs`)
- Terminal screen → Terminal: displays frames
