# exesdotnet/chordscalematrix architecture

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

- Interactive diagram: https://gitdiagram.com/exesdotnet/chordscalematrix
- Repository: https://github.com/exesdotnet/chordscalematrix

## Overview

ChordScaleMatrix is a SuperCollider step sequencer for exploring scales, chords, tunings, and progressions. The documented workflow is to work in a matrix, generate scale notes or place chord progressions, then send music to another MIDI device; documents can also be saved for later editing. The README identifies external SuperCollider and ChordSymbol dependencies and MIDI-related extensions. No source excerpts were provided, so the graph shows only README-documented behavior and does not infer internal calls.

Main entry points: [`ChordScaleMatrix.scd`](https://github.com/exesdotnet/chordscalematrix/blob/master/ChordScaleMatrix.scd) (ChordScaleMatrix), [`main.csmx`](https://github.com/exesdotnet/chordscalematrix/blob/master/main.csmx) (Saved Documents)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_matrix["Matrix Editing"]
  node_app["ChordScaleMatrix"]
  node_matrix_window["Matrix Window"]
end

subgraph group_music["Music Creation"]
  node_scale_notes["Scale Notes"]
  node_chord_progressions["Chord Progressions"]
end

subgraph group_documents["Documents"]
  node_saved_documents["Saved Documents<br/>[main.csmx]"]
end

node_user(("Musician"))
node_supercollider["SuperCollider"]
node_midi_device["MIDI Device"]
node_chordsymbol["ChordSymbol"]

node_user -->|"runs"| node_app
node_app -->|"runs in"| node_supercollider
node_user -->|"edits"| node_matrix_window
node_matrix_window -->|"creates"| node_scale_notes
node_matrix_window -->|"creates"| node_chord_progressions
node_app -->|"sends MIDI"| node_midi_device
node_app -->|"saves edits"| node_saved_documents
node_app -.->|"requires"| node_chordsymbol

click node_app "https://github.com/exesdotnet/chordscalematrix/blob/master/ChordScaleMatrix.scd"
click node_matrix_window "https://github.com/exesdotnet/chordscalematrix/blob/master/ChordScaleMatrix.scd"
click node_scale_notes "https://github.com/exesdotnet/chordscalematrix/blob/master/ChordScaleMatrix.scd"
click node_chord_progressions "https://github.com/exesdotnet/chordscalematrix/blob/master/ChordScaleMatrix.scd"
click node_saved_documents "https://github.com/exesdotnet/chordscalematrix/blob/master/main.csmx"

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_app,node_matrix_window toneBlue
class node_scale_notes,node_chord_progressions toneAmber
class node_saved_documents toneMint
class node_user,node_supercollider,node_midi_device,node_chordsymbol toneIndigo
```

## Components

### Matrix Editing

- [ChordScaleMatrix](https://github.com/exesdotnet/chordscalematrix/blob/master/ChordScaleMatrix.scd): `ChordScaleMatrix.scd`
- [Matrix Window](https://github.com/exesdotnet/chordscalematrix/blob/master/ChordScaleMatrix.scd): `ChordScaleMatrix.scd`

### Music Creation

- [Scale Notes](https://github.com/exesdotnet/chordscalematrix/blob/master/ChordScaleMatrix.scd): `ChordScaleMatrix.scd`
- [Chord Progressions](https://github.com/exesdotnet/chordscalematrix/blob/master/ChordScaleMatrix.scd): `ChordScaleMatrix.scd`

### Documents

- [Saved Documents](https://github.com/exesdotnet/chordscalematrix/blob/master/main.csmx): `main.csmx`

### Other components

- **Musician**
- **SuperCollider**
- **MIDI Device**
- **ChordSymbol**

## Connections

- Musician → ChordScaleMatrix: runs (evidence: `README.md`)
- ChordScaleMatrix → SuperCollider: runs in (evidence: `README.md`)
- Musician → Matrix Window: edits (evidence: `README.md`)
- Matrix Window → Scale Notes: creates (evidence: `README.md`)
- Matrix Window → Chord Progressions: creates (evidence: `README.md`)
- ChordScaleMatrix → MIDI Device: sends MIDI (evidence: `README.md`)
- ChordScaleMatrix → Saved Documents: saves edits (evidence: `README.md`)
- ChordScaleMatrix → ChordSymbol: requires (evidence: `README.md`)
