# googlecreativelab/chrome-music-lab architecture

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

- Interactive diagram: https://gitdiagram.com/googlecreativelab/chrome-music-lab
- Repository: https://github.com/googlecreativelab/chrome-music-lab

## Overview

This repository is a collection of browser-based Chrome Music Lab experiments, not one application. Users interact with individual musical interfaces to create, play, record, or visualize sound. The graph preserves the distinct experiment areas and the internal stages visible in the supplied excerpts. Several projects’ source was not sampled, so their internal relationships are left unasserted; dashed, uncited links indicate only an unverified user entry point.

Main entry points: [`soundspinner/app/Main.js`](https://github.com/googlecreativelab/chrome-music-lab/blob/master/soundspinner/app/Main.js) (Soundspinner interface), [`soundwaves/src/js/main.js`](https://github.com/googlecreativelab/chrome-music-lab/blob/master/soundwaves/src/js/main.js) (Soundwaves experience), [`spectrogram/src/javascripts/UI/spectrogram.js`](https://github.com/googlecreativelab/chrome-music-lab/blob/master/spectrogram/src/javascripts/UI/spectrogram.js) (Spectrogram interface), [`spectrogram/src/javascripts/main.js`](https://github.com/googlecreativelab/chrome-music-lab/blob/master/spectrogram/src/javascripts/main.js) (Experiment controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_strings["String Experiments"]
  node_harmonics["Harmonics and strings<br/>[index.js]"]
  node_threadcontrol["Thread controller"]
end

subgraph group_composition["Music Making"]
  node_arpeggios["Arpeggios interface<br/>[Main.js]"]
  node_arpdata["Arpeggio parts<br/>[Parts.js]"]
  node_arpfileplay["File playback<br/>[Player.js]"]
  node_chords["Chord interface<br/>[Main.js]"]
  node_chordkeyboard["Piano keyboard<br/>[Piano.js]"]
  node_chordplayer["Chord playback<br/>[Player.js]"]
  node_melody["Melody maker<br/>[Main.js]"]
  node_melodygrid["Melody grid<br/>[Grid.js]"]
  node_melodyai["Grid AI<br/>[AI.js]"]
  node_melodyplayer["Melody playback<br/>[Player.js]"]
  node_pianoroll["Piano roll interface<br/>[Main.js]"]
  node_roll["Score roll<br/>[Roll.js]"]
  node_score["Score model<br/>[Score.js]"]
  node_fileplay["File playback<br/>[Player.js]"]
end

subgraph group_capture["Audio Capture"]
  node_mic["Microphone recording<br/>[Recorder.js]"]
  node_waveform["Waveform display<br/>[Waveform.js]"]
  node_spinner["Soundspinner interface<br/>[Main.js]"]
  node_spinnerui["Recording controls<br/>[UserInterface.js]"]
  node_spinnerrec["Audio recorder<br/>[Recorder.js]"]
  node_spinnerwave["Waveform display<br/>[Waveform.js]"]
end

subgraph group_visuals["Sound Visualization"]
  node_spectrogram["Spectrogram interface<br/>[spectrogram.js]"]
  node_specmain["Experiment controls<br/>[main.js]"]
  node_specplayer["Audio player<br/>[player.js]"]
  node_visualizer["3D visualizer<br/>[visualizer.js]"]
end

subgraph group_interactive["Interactive Sound"]
  node_soundwaves["Soundwaves experience<br/>[main.js]"]
  node_keys["Playable keys<br/>[keys.js]"]
  node_piano["Piano interaction<br/>[piano.js]"]
  node_dots["Dot rendering<br/>[dots.js]"]
  node_math["Math utilities<br/>[math.js]"]
end

node_user(("Experiment user"))

node_user -.->|"interacts with"| node_harmonics
node_user -.->|"uses"| node_arpeggios
node_user -.->|"uses"| node_chords
node_user -.->|"uses"| node_melody
node_user -.->|"uses"| node_pianoroll
node_user -.->|"uses"| node_spinner
node_user -.->|"uses"| node_specmain
node_user -.->|"plays"| node_soundwaves
node_threadcontrol -.->|"supports interaction"| node_harmonics
node_spinner -->|"creates"| node_spinnerui
node_spinner -->|"records audio"| node_spinnerrec
node_spinner -->|"creates"| node_spinnerwave
node_specmain -->|"loads"| node_spectrogram
node_spectrogram -->|"creates"| node_specplayer
node_spectrogram -->|"uses"| node_visualizer
node_soundwaves -->|"renders"| node_dots
node_soundwaves -->|"creates"| node_keys
node_soundwaves -->|"creates"| node_piano
node_keys -->|"uses"| node_math
node_dots -.->|"uses"| node_math

click node_harmonics "https://github.com/googlecreativelab/chrome-music-lab/blob/master/harmonics%20%26%20strings/js/index.js"
click node_threadcontrol "https://github.com/googlecreativelab/chrome-music-lab/blob/master/harmonics%20%26%20strings/js/ThreadController.js"
click node_arpeggios "https://github.com/googlecreativelab/chrome-music-lab/blob/master/arpeggios/app/Main.js"
click node_arpdata "https://github.com/googlecreativelab/chrome-music-lab/blob/master/arpeggios/app/data/Parts.js"
click node_arpfileplay "https://github.com/googlecreativelab/chrome-music-lab/blob/master/arpeggios/app/fileplayer/Player.js"
click node_chords "https://github.com/googlecreativelab/chrome-music-lab/blob/master/chords/app/Main.js"
click node_chordkeyboard "https://github.com/googlecreativelab/chrome-music-lab/blob/master/chords/app/keyboard/Piano.js"
click node_chordplayer "https://github.com/googlecreativelab/chrome-music-lab/blob/master/chords/app/sound/Player.js"
click node_melody "https://github.com/googlecreativelab/chrome-music-lab/blob/master/melodymaker/app/Main.js"
click node_melodygrid "https://github.com/googlecreativelab/chrome-music-lab/blob/master/melodymaker/app/grid/Grid.js"
click node_melodyai "https://github.com/googlecreativelab/chrome-music-lab/blob/master/melodymaker/app/grid/AI.js"
click node_melodyplayer "https://github.com/googlecreativelab/chrome-music-lab/blob/master/melodymaker/app/sound/Player.js"
click node_pianoroll "https://github.com/googlecreativelab/chrome-music-lab/blob/master/pianoroll/app/Main.js"
click node_roll "https://github.com/googlecreativelab/chrome-music-lab/blob/master/pianoroll/app/roll/Roll.js"
click node_score "https://github.com/googlecreativelab/chrome-music-lab/blob/master/pianoroll/app/roll/Score.js"
click node_fileplay "https://github.com/googlecreativelab/chrome-music-lab/blob/master/pianoroll/app/fileplayer/Player.js"
click node_mic "https://github.com/googlecreativelab/chrome-music-lab/blob/master/pianoroll/app/mic/Recorder.js"
click node_waveform "https://github.com/googlecreativelab/chrome-music-lab/blob/master/pianoroll/app/mic/Waveform.js"
click node_spinner "https://github.com/googlecreativelab/chrome-music-lab/blob/master/soundspinner/app/Main.js"
click node_spinnerui "https://github.com/googlecreativelab/chrome-music-lab/blob/master/soundspinner/app/interface/UserInterface.js"
click node_spinnerrec "https://github.com/googlecreativelab/chrome-music-lab/blob/master/soundspinner/app/mic/Recorder.js"
click node_spinnerwave "https://github.com/googlecreativelab/chrome-music-lab/blob/master/soundspinner/app/mic/Waveform.js"
click node_spectrogram "https://github.com/googlecreativelab/chrome-music-lab/blob/master/spectrogram/src/javascripts/UI/spectrogram.js"
click node_specmain "https://github.com/googlecreativelab/chrome-music-lab/blob/master/spectrogram/src/javascripts/main.js"
click node_specplayer "https://github.com/googlecreativelab/chrome-music-lab/blob/master/spectrogram/src/javascripts/UI/player.js"
click node_visualizer "https://github.com/googlecreativelab/chrome-music-lab/blob/master/spectrogram/src/javascripts/3D/visualizer.js"
click node_soundwaves "https://github.com/googlecreativelab/chrome-music-lab/blob/master/soundwaves/src/js/main.js"
click node_keys "https://github.com/googlecreativelab/chrome-music-lab/blob/master/soundwaves/src/js/keys.js"
click node_piano "https://github.com/googlecreativelab/chrome-music-lab/blob/master/soundwaves/src/js/piano.js"
click node_dots "https://github.com/googlecreativelab/chrome-music-lab/blob/master/soundwaves/src/js/dots.js"
click node_math "https://github.com/googlecreativelab/chrome-music-lab/blob/master/soundwaves/src/js/math.js"

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_harmonics,node_threadcontrol,node_user toneBlue
class node_arpeggios,node_arpdata,node_arpfileplay,node_chords,node_chordkeyboard,node_chordplayer,node_melody,node_melodygrid,node_melodyai,node_melodyplayer,node_pianoroll,node_roll,node_score,node_fileplay toneAmber
class node_mic,node_waveform,node_spinner,node_spinnerui,node_spinnerrec,node_spinnerwave toneMint
class node_spectrogram,node_specmain,node_specplayer,node_visualizer toneRose
class node_soundwaves,node_keys,node_piano,node_dots,node_math toneIndigo
```

## Components

### String Experiments

- [Harmonics and strings](https://github.com/googlecreativelab/chrome-music-lab/blob/master/harmonics%20%26%20strings/js/index.js): `harmonics & strings/js/index.js`
- [Thread controller](https://github.com/googlecreativelab/chrome-music-lab/blob/master/harmonics%20%26%20strings/js/ThreadController.js): `harmonics & strings/js/ThreadController.js`

### Music Making

- [Arpeggios interface](https://github.com/googlecreativelab/chrome-music-lab/blob/master/arpeggios/app/Main.js): `arpeggios/app/Main.js`
- [Arpeggio parts](https://github.com/googlecreativelab/chrome-music-lab/blob/master/arpeggios/app/data/Parts.js): `arpeggios/app/data/Parts.js`
- [File playback](https://github.com/googlecreativelab/chrome-music-lab/blob/master/arpeggios/app/fileplayer/Player.js): `arpeggios/app/fileplayer/Player.js`
- [Chord interface](https://github.com/googlecreativelab/chrome-music-lab/blob/master/chords/app/Main.js): `chords/app/Main.js`
- [Piano keyboard](https://github.com/googlecreativelab/chrome-music-lab/blob/master/chords/app/keyboard/Piano.js): `chords/app/keyboard/Piano.js`
- [Chord playback](https://github.com/googlecreativelab/chrome-music-lab/blob/master/chords/app/sound/Player.js): `chords/app/sound/Player.js`
- [Melody maker](https://github.com/googlecreativelab/chrome-music-lab/blob/master/melodymaker/app/Main.js): `melodymaker/app/Main.js`
- [Melody grid](https://github.com/googlecreativelab/chrome-music-lab/blob/master/melodymaker/app/grid/Grid.js): `melodymaker/app/grid/Grid.js`
- [Grid AI](https://github.com/googlecreativelab/chrome-music-lab/blob/master/melodymaker/app/grid/AI.js): `melodymaker/app/grid/AI.js`
- [Melody playback](https://github.com/googlecreativelab/chrome-music-lab/blob/master/melodymaker/app/sound/Player.js): `melodymaker/app/sound/Player.js`
- [Piano roll interface](https://github.com/googlecreativelab/chrome-music-lab/blob/master/pianoroll/app/Main.js): `pianoroll/app/Main.js`
- [Score roll](https://github.com/googlecreativelab/chrome-music-lab/blob/master/pianoroll/app/roll/Roll.js): `pianoroll/app/roll/Roll.js`
- [Score model](https://github.com/googlecreativelab/chrome-music-lab/blob/master/pianoroll/app/roll/Score.js): `pianoroll/app/roll/Score.js`
- [File playback](https://github.com/googlecreativelab/chrome-music-lab/blob/master/pianoroll/app/fileplayer/Player.js): `pianoroll/app/fileplayer/Player.js`

### Audio Capture

- [Microphone recording](https://github.com/googlecreativelab/chrome-music-lab/blob/master/pianoroll/app/mic/Recorder.js): `pianoroll/app/mic/Recorder.js`
- [Waveform display](https://github.com/googlecreativelab/chrome-music-lab/blob/master/pianoroll/app/mic/Waveform.js): `pianoroll/app/mic/Waveform.js`
- [Soundspinner interface](https://github.com/googlecreativelab/chrome-music-lab/blob/master/soundspinner/app/Main.js): `soundspinner/app/Main.js`
- [Recording controls](https://github.com/googlecreativelab/chrome-music-lab/blob/master/soundspinner/app/interface/UserInterface.js): `soundspinner/app/interface/UserInterface.js`
- [Audio recorder](https://github.com/googlecreativelab/chrome-music-lab/blob/master/soundspinner/app/mic/Recorder.js): `soundspinner/app/mic/Recorder.js`
- [Waveform display](https://github.com/googlecreativelab/chrome-music-lab/blob/master/soundspinner/app/mic/Waveform.js): `soundspinner/app/mic/Waveform.js`

### Sound Visualization

- [Spectrogram interface](https://github.com/googlecreativelab/chrome-music-lab/blob/master/spectrogram/src/javascripts/UI/spectrogram.js): `spectrogram/src/javascripts/UI/spectrogram.js`
- [Experiment controls](https://github.com/googlecreativelab/chrome-music-lab/blob/master/spectrogram/src/javascripts/main.js): `spectrogram/src/javascripts/main.js`
- [Audio player](https://github.com/googlecreativelab/chrome-music-lab/blob/master/spectrogram/src/javascripts/UI/player.js): `spectrogram/src/javascripts/UI/player.js`
- [3D visualizer](https://github.com/googlecreativelab/chrome-music-lab/blob/master/spectrogram/src/javascripts/3D/visualizer.js): `spectrogram/src/javascripts/3D/visualizer.js`

### Interactive Sound

- [Soundwaves experience](https://github.com/googlecreativelab/chrome-music-lab/blob/master/soundwaves/src/js/main.js): `soundwaves/src/js/main.js`
- [Playable keys](https://github.com/googlecreativelab/chrome-music-lab/blob/master/soundwaves/src/js/keys.js): `soundwaves/src/js/keys.js`
- [Piano interaction](https://github.com/googlecreativelab/chrome-music-lab/blob/master/soundwaves/src/js/piano.js): `soundwaves/src/js/piano.js`
- [Dot rendering](https://github.com/googlecreativelab/chrome-music-lab/blob/master/soundwaves/src/js/dots.js): `soundwaves/src/js/dots.js`
- [Math utilities](https://github.com/googlecreativelab/chrome-music-lab/blob/master/soundwaves/src/js/math.js): `soundwaves/src/js/math.js`

### Other components

- **Experiment user**

## Connections

- Experiment user → Harmonics and strings: interacts with
- Experiment user → Arpeggios interface: uses
- Experiment user → Chord interface: uses
- Experiment user → Melody maker: uses
- Experiment user → Piano roll interface: uses
- Experiment user → Soundspinner interface: uses
- Experiment user → Experiment controls: uses
- Experiment user → Soundwaves experience: plays
- Thread controller → Harmonics and strings: supports interaction
- Soundspinner interface → Recording controls: creates (evidence: `soundspinner/app/Main.js`)
- Soundspinner interface → Audio recorder: records audio (evidence: `soundspinner/app/Main.js`)
- Soundspinner interface → Waveform display: creates (evidence: `soundspinner/app/Main.js`)
- Experiment controls → Spectrogram interface: loads (evidence: `spectrogram/src/javascripts/main.js`)
- Spectrogram interface → Audio player: creates (evidence: `spectrogram/src/javascripts/UI/spectrogram.js`)
- Spectrogram interface → 3D visualizer: uses (evidence: `spectrogram/src/javascripts/UI/spectrogram.js`)
- Soundwaves experience → Dot rendering: renders (evidence: `soundwaves/src/js/main.js`)
- Soundwaves experience → Playable keys: creates (evidence: `soundwaves/src/js/main.js`)
- Soundwaves experience → Piano interaction: creates (evidence: `soundwaves/src/js/main.js`)
- Playable keys → Math utilities: uses (evidence: `soundwaves/src/js/keys.js`)
- Dot rendering → Math utilities: uses (evidence: `soundwaves/src/js/dots.js`)
