# georg101/automated-music-score-generator---amsg architecture

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

- Interactive diagram: https://gitdiagram.com/georg101/automated-music-score-generator---amsg
- Repository: https://github.com/georg101/automated-music-score-generator---amsg

## Overview

ASMG is a desktop music-score generator with a PyQt interface. The visible workflow connects Generate to score generation and file output; Play starts a background playback routine that reads and decodes score data into note frequencies and durations. The excerpt does not show the complete file-handling or audio-output implementation, so those details are not asserted beyond the visible calls.

Main entry points: [`main.py`](https://github.com/georg101/automated-music-score-generator---amsg/blob/Full-version/main.py) (PyQt interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop application"]
  node_interface["PyQt interface<br/>[main.py]"]
end

subgraph group_music["Score and playback"]
  node_generator["Score generator<br/>[main.py]"]
  node_score["Score file"]
  node_playback["Playback worker<br/>[main.py]"]
end

node_user(("User"))
node_audio["Audio output"]

node_user -->|"uses"| node_interface
node_interface -->|"invokes generation"| node_generator
node_generator -->|"writes score"| node_score
node_interface -->|"starts playback"| node_playback
node_playback -->|"reads score"| node_score
node_playback -.->|"plays notes"| node_audio

click node_interface "https://github.com/georg101/automated-music-score-generator---amsg/blob/Full-version/main.py"
click node_generator "https://github.com/georg101/automated-music-score-generator---amsg/blob/Full-version/main.py"
click node_playback "https://github.com/georg101/automated-music-score-generator---amsg/blob/Full-version/main.py"

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_interface,node_user toneBlue
class node_generator,node_score,node_playback toneAmber
class node_audio toneIndigo
```

## Components

### Desktop application

- [PyQt interface](https://github.com/georg101/automated-music-score-generator---amsg/blob/Full-version/main.py): `main.py`

### Score and playback

- [Score generator](https://github.com/georg101/automated-music-score-generator---amsg/blob/Full-version/main.py): `main.py`
- **Score file**
- [Playback worker](https://github.com/georg101/automated-music-score-generator---amsg/blob/Full-version/main.py): `main.py`

### Other components

- **User**
- **Audio output**

## Connections

- User → PyQt interface: uses (evidence: `README.md`)
- PyQt interface → Score generator: invokes generation (evidence: `main.py`)
- Score generator → Score file: writes score (evidence: `main.py`)
- PyQt interface → Playback worker: starts playback (evidence: `main.py`)
- Playback worker → Score file: reads score (evidence: `main.py`)
- Playback worker → Audio output: plays notes
