# piratecz/gtav-radio architecture

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

- Interactive diagram: https://gitdiagram.com/piratecz/gtav-radio
- Repository: https://github.com/piratecz/gtav-radio

## Overview

This is a small Windows Forms GTA V radio player. At startup, the app opens its media-player form, which loads the configured station’s WAV songs, song intros, and DJ-lore clips from local folders. It randomly plays songs without repeats, may play a matching intro or DJ-lore clip, and updates player volume from the form’s slider. The form uses Windows Media Player for playback. Source excerpts do not establish how the audio assets are packaged or whether other stations are usable.

Main entry points: [`GTAV radio/Form1.cs`](https://github.com/piratecz/gtav-radio/blob/main/GTAV%20radio/Form1.cs) (Media player), [`GTAV radio/Program.cs`](https://github.com/piratecz/gtav-radio/blob/main/GTAV%20radio/Program.cs) (App entry), [`GTAV radio/bin/Debug/res/sound/nonstoppop`](https://github.com/piratecz/gtav-radio/tree/main/GTAV%20radio/bin/Debug/res/sound/nonstoppop) (Station audio)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Application startup"]
  node_program["App entry<br/>[Program.cs]"]
end

subgraph group_playback["Radio playback"]
  node_media_player["Media player<br/>[Form1.cs]"]
  node_station_audio["Station audio"]
end

node_listener(("Listener"))
node_windows_media_player["Windows Media Player"]

node_listener -.->|"opens app"| node_program
node_program -->|"starts form"| node_media_player
node_media_player -->|"loads WAV files"| node_station_audio
node_media_player -->|"controls playback"| node_windows_media_player

click node_program "https://github.com/piratecz/gtav-radio/blob/main/GTAV%20radio/Program.cs"
click node_media_player "https://github.com/piratecz/gtav-radio/blob/main/GTAV%20radio/Form1.cs"
click node_station_audio "https://github.com/piratecz/gtav-radio/tree/main/GTAV%20radio/bin/Debug/res/sound/nonstoppop"

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 toneBlue
class node_media_player,node_station_audio toneAmber
class node_listener,node_windows_media_player toneIndigo
```

## Components

### Application startup

- [App entry](https://github.com/piratecz/gtav-radio/blob/main/GTAV%20radio/Program.cs): `GTAV radio/Program.cs`

### Radio playback

- [Media player](https://github.com/piratecz/gtav-radio/blob/main/GTAV%20radio/Form1.cs): `GTAV radio/Form1.cs`
- [Station audio](https://github.com/piratecz/gtav-radio/tree/main/GTAV%20radio/bin/Debug/res/sound/nonstoppop): `GTAV radio/bin/Debug/res/sound/nonstoppop`

### Other components

- **Listener**
- **Windows Media Player**

## Connections

- Listener → App entry: opens app
- App entry → Media player: starts form (evidence: `GTAV radio/Program.cs`)
- Media player → Station audio: loads WAV files (evidence: `GTAV radio/Form1.cs`)
- Media player → Windows Media Player: controls playback (evidence: `GTAV radio/Form1.cs`)
