# srrudic/amplitude architecture

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

- Interactive diagram: https://gitdiagram.com/srrudic/amplitude
- Repository: https://github.com/srrudic/amplitude

## Overview

Amplitude is a compact Windows/Linux audio player. A user supplies files, a playlist or a stream; the application coordinates playback, presents the player interface, and delegates audio decoding and device interaction to internal modules. Its documented capabilities also include audio CDs, custom skins, equalisation, presets and desktop media controls. The excerpts show audio’s use of codecs, streams and CD support, but do not expose most of the main-loop wiring; those links are marked dashed with no evidence path rather than asserted as observed calls.

Main entry points: [`src/main.c`](https://github.com/srrudic/amplitude/blob/main/src/main.c) (App controller), [`src/codec.c`](https://github.com/srrudic/amplitude/blob/main/src/codec.c) (Decoder dispatch), [`src/audio.c`](https://github.com/srrudic/amplitude/blob/main/src/audio.c) (Audio engine), [`src/platform_x11.c`](https://github.com/srrudic/amplitude/blob/main/src/platform_x11.c) (Window and input)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_main["App controller<br/>[main.c]"]
  node_config["Settings<br/>[config.c]"]
end

subgraph group_playback["Playback"]
  node_playlist["Playlist<br/>[playlist.c]"]
  node_audio["Audio engine<br/>[audio.c]"]
  node_codec["Decoder dispatch<br/>[codec.c]"]
  node_aac["AAC decoder<br/>[codec_aac.c]"]
  node_vorbis["Vorbis decoder<br/>[codec_vorbis.c]"]
  node_opus["Opus decoder<br/>[codec_opus.c]"]
  node_modules["Tracker decoder<br/>[codec_mod.c]"]
  node_stream["Internet streams<br/>[stream.c]"]
  node_cd["CD playback<br/>[cd.c]"]
  node_cdnames["CD names<br/>[cdnames.c]"]
  node_tags["Track metadata<br/>[tags.c]"]
end

subgraph group_interface["Interface"]
  node_ui["Player rendering<br/>[ui.c]"]
  node_dialogs["Player dialogs<br/>[ui_dialog.c]"]
  node_skin["Skins and themes<br/>[skin.c]"]
  node_gfx["Graphics primitives<br/>[gfx.c]"]
end

subgraph group_system["System integration"]
  node_platform["Window and input<br/>[platform_x11.c]"]
  node_mpris["MPRIS controls<br/>[mpris.c]"]
  node_smtc["Windows controls<br/>[smtc.c]"]
end

node_user(("Listener"))

node_user -.->|"starts or controls"| node_main
node_main -->|"shuts down"| node_audio
node_main -->|"creates windows"| node_platform
node_main -->|"randomizes tracks"| node_playlist
node_main -.->|"loads settings"| node_config
node_main -.->|"handles interface"| node_ui
node_main -.->|"opens dialogs"| node_dialogs
node_main -.->|"selects appearance"| node_skin
node_main -.->|"offers CD lookup"| node_cdnames
node_audio -.->|"opens decoders"| node_codec
node_audio -->|"feeds stream audio"| node_stream
node_audio -->|"uses CD playback"| node_cd
node_codec -.->|"dispatches to"| node_aac
node_codec -.->|"dispatches to"| node_vorbis
node_codec -.->|"dispatches to"| node_opus
node_codec -.->|"dispatches to"| node_modules
node_cd -->|"reads metadata"| node_tags
node_playlist -->|"reads metadata"| node_tags
node_ui -.->|"draws with"| node_skin
node_skin -->|"uses primitives"| node_gfx
node_platform -->|"dispatches media commands"| node_mpris
node_platform -.->|"uses Windows controls"| node_smtc

click node_main "https://github.com/srrudic/amplitude/blob/main/src/main.c"
click node_config "https://github.com/srrudic/amplitude/blob/main/src/config.c"
click node_playlist "https://github.com/srrudic/amplitude/blob/main/src/playlist.c"
click node_audio "https://github.com/srrudic/amplitude/blob/main/src/audio.c"
click node_codec "https://github.com/srrudic/amplitude/blob/main/src/codec.c"
click node_aac "https://github.com/srrudic/amplitude/blob/main/src/codec_aac.c"
click node_vorbis "https://github.com/srrudic/amplitude/blob/main/src/codec_vorbis.c"
click node_opus "https://github.com/srrudic/amplitude/blob/main/src/codec_opus.c"
click node_modules "https://github.com/srrudic/amplitude/blob/main/src/codec_mod.c"
click node_stream "https://github.com/srrudic/amplitude/blob/main/src/stream.c"
click node_cd "https://github.com/srrudic/amplitude/blob/main/src/cd.c"
click node_cdnames "https://github.com/srrudic/amplitude/blob/main/src/cdnames.c"
click node_tags "https://github.com/srrudic/amplitude/blob/main/src/tags.c"
click node_ui "https://github.com/srrudic/amplitude/blob/main/src/ui.c"
click node_dialogs "https://github.com/srrudic/amplitude/blob/main/src/ui_dialog.c"
click node_skin "https://github.com/srrudic/amplitude/blob/main/src/skin.c"
click node_gfx "https://github.com/srrudic/amplitude/blob/main/src/gfx.c"
click node_platform "https://github.com/srrudic/amplitude/blob/main/src/platform_x11.c"
click node_mpris "https://github.com/srrudic/amplitude/blob/main/src/mpris.c"
click node_smtc "https://github.com/srrudic/amplitude/blob/main/src/smtc.c"

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_main,node_config toneBlue
class node_playlist,node_audio,node_codec,node_aac,node_vorbis,node_opus,node_modules,node_stream,node_cd,node_cdnames,node_tags toneAmber
class node_ui,node_dialogs,node_skin,node_gfx toneMint
class node_platform,node_mpris,node_smtc toneRose
class node_user toneIndigo
```

## Components

### Application

- [App controller](https://github.com/srrudic/amplitude/blob/main/src/main.c): `src/main.c`
- [Settings](https://github.com/srrudic/amplitude/blob/main/src/config.c): `src/config.c`

### Playback

- [Playlist](https://github.com/srrudic/amplitude/blob/main/src/playlist.c): `src/playlist.c`
- [Audio engine](https://github.com/srrudic/amplitude/blob/main/src/audio.c): `src/audio.c`
- [Decoder dispatch](https://github.com/srrudic/amplitude/blob/main/src/codec.c): `src/codec.c`
- [AAC decoder](https://github.com/srrudic/amplitude/blob/main/src/codec_aac.c): `src/codec_aac.c`
- [Vorbis decoder](https://github.com/srrudic/amplitude/blob/main/src/codec_vorbis.c): `src/codec_vorbis.c`
- [Opus decoder](https://github.com/srrudic/amplitude/blob/main/src/codec_opus.c): `src/codec_opus.c`
- [Tracker decoder](https://github.com/srrudic/amplitude/blob/main/src/codec_mod.c): `src/codec_mod.c`
- [Internet streams](https://github.com/srrudic/amplitude/blob/main/src/stream.c): `src/stream.c`
- [CD playback](https://github.com/srrudic/amplitude/blob/main/src/cd.c): `src/cd.c`
- [CD names](https://github.com/srrudic/amplitude/blob/main/src/cdnames.c): `src/cdnames.c`
- [Track metadata](https://github.com/srrudic/amplitude/blob/main/src/tags.c): `src/tags.c`

### Interface

- [Player rendering](https://github.com/srrudic/amplitude/blob/main/src/ui.c): `src/ui.c`
- [Player dialogs](https://github.com/srrudic/amplitude/blob/main/src/ui_dialog.c): `src/ui_dialog.c`
- [Skins and themes](https://github.com/srrudic/amplitude/blob/main/src/skin.c): `src/skin.c`
- [Graphics primitives](https://github.com/srrudic/amplitude/blob/main/src/gfx.c): `src/gfx.c`

### System integration

- [Window and input](https://github.com/srrudic/amplitude/blob/main/src/platform_x11.c): `src/platform_x11.c`
- [MPRIS controls](https://github.com/srrudic/amplitude/blob/main/src/mpris.c): `src/mpris.c`
- [Windows controls](https://github.com/srrudic/amplitude/blob/main/src/smtc.c): `src/smtc.c`

### Other components

- **Listener**

## Connections

- Listener → App controller: starts or controls
- App controller → Audio engine: shuts down (evidence: `src/main.c`)
- App controller → Window and input: creates windows (evidence: `src/main.c`)
- App controller → Playlist: randomizes tracks (evidence: `src/main.c`)
- App controller → Settings: loads settings
- App controller → Player rendering: handles interface
- App controller → Player dialogs: opens dialogs
- App controller → Skins and themes: selects appearance
- App controller → CD names: offers CD lookup
- Audio engine → Decoder dispatch: opens decoders
- Audio engine → Internet streams: feeds stream audio (evidence: `src/audio.c`)
- Audio engine → CD playback: uses CD playback (evidence: `src/audio.c`)
- Decoder dispatch → AAC decoder: dispatches to
- Decoder dispatch → Vorbis decoder: dispatches to
- Decoder dispatch → Opus decoder: dispatches to
- Decoder dispatch → Tracker decoder: dispatches to
- CD playback → Track metadata: reads metadata (evidence: `src/cd.c`)
- Playlist → Track metadata: reads metadata (evidence: `src/playlist.c`)
- Player rendering → Skins and themes: draws with
- Skins and themes → Graphics primitives: uses primitives (evidence: `src/skin.c`)
- Window and input → MPRIS controls: dispatches media commands (evidence: `src/platform_x11.c`)
- Window and input → Windows controls: uses Windows controls
