# sam-astro/astro8-computer architecture

> Architecture diagram of the GitHub repository sam-astro/astro8-computer, 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/sam-astro/astro8-computer
- Repository: https://github.com/sam-astro/astro8-computer

## Overview

Astro-8 is a 16-bit computer project with a desktop emulator, an Armstrong compiler, an assembly programming path, and a Logisim circuit. The main workflow is a user running a program through the emulator, where the compiler can translate Armstrong source and the emulator provides the computer runtime, display, and audio. VSSynth is a substantial internal audio layer; the repository also includes webcam capture and console-formatting helpers. Some runtime wiring is only partially excerpted, so unsampled relationships are omitted.

Main entry points: [`Astro8-Emulator/main.cpp`](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/main.cpp) (Astro-8 emulator), [`Astro8-Emulator/VSSynth/Synthesizer.h`](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/Synthesizer.h) (Audio synthesizer), [`Astro8-Emulator/colorprint.h`](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/colorprint.h) (Colored console output), [`Astro8-Emulator/VSSynth/generators/Instrument.h`](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/generators/Instrument.h) (Instruments)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Computer runtime"]
  node_emulator["Astro-8 emulator<br/>[main.cpp]"]
  node_computer["Computer circuit<br/>[cpu-circuit.circ]"]
end

subgraph group_languages["Programming languages"]
  node_armstrong["Armstrong compiler"]
  node_assembly["Assembly support<br/>[assembler.cpp]"]
end

subgraph group_audio["Audio synthesis"]
  node_synth["Audio synthesizer<br/>[Synthesizer.h]"]
  node_generator["Sound generators<br/>[SoundGenerator.h]"]
  node_instrument["Instruments<br/>[Instrument.h]"]
  node_sequencer["Note sequencer<br/>[Sequencer.h]"]
  node_envelope["ADSR envelopes<br/>[Envelope.h]"]
  node_patches["Instrument patches<br/>[Patches.h]"]
  node_notes["Note frequencies<br/>[Notes.h]"]
  node_waveforms["Waveforms<br/>[Waveforms.h]"]
  node_wavwriter["WAV output<br/>[WAVWriter.h]"]
  node_middleware["Audio middleware<br/>[SynthMiddleware.h]"]
end

subgraph group_support["Runtime support"]
  node_colorprint["Colored console output<br/>[colorprint.h]"]
  node_colors["Console colors<br/>[color.hpp]"]
  node_stringops["String operations<br/>[strops.cpp]"]
  node_processing["Pixel processing<br/>[processing.h]"]
  node_webcam["Webcam capture<br/>[escapi.cpp]"]
end

node_user(("Program user"))
node_sdl["SDL audio and display"]
node_speakers(("Audio output"))

node_user -->|"runs programs"| node_emulator
node_emulator -->|"compiles source"| node_armstrong
node_user -.->|"uses circuit"| node_computer
node_emulator -->|"configures playback"| node_synth
node_synth -->|"samples generators"| node_generator
node_synth -->|"processes samples"| node_middleware
node_instrument -->|"extends"| node_generator
node_sequencer -->|"queues notes for"| node_instrument
node_instrument -->|"uses envelopes"| node_envelope
node_patches -->|"defines envelopes"| node_envelope
node_patches -->|"builds patches"| node_waveforms
node_wavwriter -->|"implements"| node_middleware
node_synth -->|"outputs audio"| node_speakers
node_emulator -->|"captures frames"| node_webcam
node_emulator -->|"draws and plays audio"| node_sdl
node_colorprint -->|"uses colors"| node_colors
node_colorprint -->|"uses string operations"| node_stringops
node_colorprint -->|"uses pixel processing"| node_processing
node_emulator -->|"processes pixels"| node_processing

click node_emulator "https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/main.cpp"
click node_computer "https://github.com/sam-astro/astro8-computer/blob/main/cpu-circuit.circ"
click node_armstrong "https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/armstrong-compiler.cpp"
click node_assembly "https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/assembler.cpp"
click node_synth "https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/Synthesizer.h"
click node_generator "https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/SoundGenerator.h"
click node_instrument "https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/generators/Instrument.h"
click node_sequencer "https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/generators/Sequencer.h"
click node_envelope "https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/utils/Envelope.h"
click node_patches "https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/utils/Patches.h"
click node_notes "https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/utils/Notes.h"
click node_waveforms "https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/utils/Waveforms.h"
click node_wavwriter "https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/middleware/WAVWriter.h"
click node_middleware "https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/SynthMiddleware.h"
click node_colorprint "https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/colorprint.h"
click node_colors "https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/color.hpp"
click node_stringops "https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/strops.cpp"
click node_processing "https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/processing.h"
click node_webcam "https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/escapi.cpp"

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_emulator,node_computer,node_user toneBlue
class node_armstrong,node_assembly toneAmber
class node_synth,node_generator,node_instrument,node_sequencer,node_envelope,node_patches,node_notes,node_waveforms,node_wavwriter,node_middleware toneMint
class node_colorprint,node_colors,node_stringops,node_processing,node_webcam toneRose
class node_sdl,node_speakers toneIndigo
```

## Components

### Computer runtime

- [Astro-8 emulator](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/main.cpp): `Astro8-Emulator/main.cpp`
- [Computer circuit](https://github.com/sam-astro/astro8-computer/blob/main/cpu-circuit.circ): `cpu-circuit.circ`

### Programming languages

- [Armstrong compiler](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/armstrong-compiler.cpp): `Astro8-Emulator/armstrong-compiler.cpp`
- [Assembly support](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/assembler.cpp): `Astro8-Emulator/assembler.cpp`

### Audio synthesis

- [Audio synthesizer](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/Synthesizer.h): `Astro8-Emulator/VSSynth/Synthesizer.h`
- [Sound generators](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/SoundGenerator.h): `Astro8-Emulator/VSSynth/SoundGenerator.h`
- [Instruments](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/generators/Instrument.h): `Astro8-Emulator/VSSynth/generators/Instrument.h`
- [Note sequencer](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/generators/Sequencer.h): `Astro8-Emulator/VSSynth/generators/Sequencer.h`
- [ADSR envelopes](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/utils/Envelope.h): `Astro8-Emulator/VSSynth/utils/Envelope.h`
- [Instrument patches](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/utils/Patches.h): `Astro8-Emulator/VSSynth/utils/Patches.h`
- [Note frequencies](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/utils/Notes.h): `Astro8-Emulator/VSSynth/utils/Notes.h`
- [Waveforms](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/utils/Waveforms.h): `Astro8-Emulator/VSSynth/utils/Waveforms.h`
- [WAV output](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/middleware/WAVWriter.h): `Astro8-Emulator/VSSynth/middleware/WAVWriter.h`
- [Audio middleware](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/VSSynth/SynthMiddleware.h): `Astro8-Emulator/VSSynth/SynthMiddleware.h`

### Runtime support

- [Colored console output](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/colorprint.h): `Astro8-Emulator/colorprint.h`
- [Console colors](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/color.hpp): `Astro8-Emulator/color.hpp`
- [String operations](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/strops.cpp): `Astro8-Emulator/strops.cpp`
- [Pixel processing](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/processing.h): `Astro8-Emulator/processing.h`
- [Webcam capture](https://github.com/sam-astro/astro8-computer/blob/main/Astro8-Emulator/escapi.cpp): `Astro8-Emulator/escapi.cpp`

### Other components

- **Program user**
- **SDL audio and display**
- **Audio output**

## Connections

- Program user → Astro-8 emulator: runs programs (evidence: `README.md`)
- Astro-8 emulator → Armstrong compiler: compiles source (evidence: `Astro8-Emulator/main.cpp`)
- Program user → Computer circuit: uses circuit (evidence: `README.md`)
- Astro-8 emulator → Audio synthesizer: configures playback (evidence: `Astro8-Emulator/main.cpp`)
- Audio synthesizer → Sound generators: samples generators (evidence: `Astro8-Emulator/VSSynth/Synthesizer.h`)
- Audio synthesizer → Audio middleware: processes samples (evidence: `Astro8-Emulator/VSSynth/Synthesizer.h`)
- Instruments → Sound generators: extends (evidence: `Astro8-Emulator/VSSynth/generators/Instrument.h`)
- Note sequencer → Instruments: queues notes for (evidence: `Astro8-Emulator/VSSynth/generators/Sequencer.h`)
- Instruments → ADSR envelopes: uses envelopes (evidence: `Astro8-Emulator/VSSynth/generators/Instrument.h`)
- Instrument patches → ADSR envelopes: defines envelopes (evidence: `Astro8-Emulator/VSSynth/utils/Patches.h`)
- Instrument patches → Waveforms: builds patches (evidence: `Astro8-Emulator/VSSynth/utils/Patches.h`)
- WAV output → Audio middleware: implements (evidence: `Astro8-Emulator/VSSynth/middleware/WAVWriter.h`)
- Audio synthesizer → Audio output: outputs audio (evidence: `Astro8-Emulator/VSSynth/Synthesizer.h`)
- Astro-8 emulator → Webcam capture: captures frames (evidence: `Astro8-Emulator/main.cpp`)
- Astro-8 emulator → SDL audio and display: draws and plays audio (evidence: `Astro8-Emulator/main.cpp`)
- Colored console output → Console colors: uses colors (evidence: `Astro8-Emulator/colorprint.h`)
- Colored console output → String operations: uses string operations (evidence: `Astro8-Emulator/colorprint.h`)
- Colored console output → Pixel processing: uses pixel processing (evidence: `Astro8-Emulator/colorprint.h`)
- Astro-8 emulator → Pixel processing: processes pixels (evidence: `Astro8-Emulator/main.cpp`)
