# vladislavsaltanov/aria architecture

> Architecture diagram of the GitHub repository vladislavsaltanov/aria, 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/vladislavsaltanov/aria
- Repository: https://github.com/vladislavsaltanov/aria

## Overview

ARIA is a cross-platform desktop show-playback system for live sound operators. The main workflow is to import tracks into projects, arrange a queue or timed script, issue transport commands, and have the show controller drive the audio engine and output; show/library state is persisted for recovery. Separate product branches provide LAN browser control, preview/listen sessions, waveform support, and configurable hotkeys/settings. The graph follows documented capabilities and shown references; several subsystem internals are unsampled, so uncertain links are omitted rather than inferred.

Main entry points: [`src/ARIA.App/AppHost.cs`](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.App/AppHost.cs) (Runtime host), [`src/ARIA.Audio/AriaAudioEngine.cs`](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Audio/AriaAudioEngine.cs) (Audio engine), [`src/ARIA.Core/Runtime/ShowController.cs`](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Core/Runtime/ShowController.cs) (Show controller), [`src/ARIA.Core/Commands/Commands.cs`](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Core/Commands/Commands.cs) (Command types)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop operation"]
  node_app["App composition<br/>[App.axaml.cs]"]
  node_projects["Projects and tracks"]
  node_queue["Queue controls<br/>[QueueViewModel.cs]"]
  node_transport["Transport controls"]
  node_scripts["Script panel"]
  node_settings["Show settings"]
  node_remoteui["Remote panel"]
end

subgraph group_domain["Show control"]
  node_host["Runtime host<br/>[AppHost.cs]"]
  node_commands["Command types<br/>[Commands.cs]"]
  node_bus["Command bus<br/>[CommandBus.cs]"]
  node_controller["Show controller<br/>[ShowController.cs]"]
  node_showstate["Show and track model<br/>[Track.cs]"]
end

subgraph group_audio["Audio engine"]
  node_audioengine["Audio engine<br/>[AriaAudioEngine.cs]"]
  node_mixer["Mixer bus<br/>[MixerBus.cs]"]
  node_sessionmixer["Listen sessions<br/>[SessionMixer.cs]"]
  node_sourcefactory["Track decoding"]
  node_audioout["Device output<br/>[MiniaudioSink.cs]"]
  node_shim["Native audio shim<br/>[aria_shim.c]"]
end

subgraph group_data["Library and recovery"]
  node_library[("Track library<br/>[LibraryStore.cs]")]
  node_autosave["Show autosave<br/>[ShowAutosaver.cs]"]
  node_snapshot["Show snapshots<br/>[SnapshotStore.cs]"]
  node_waveforms[("Waveform cache<br/>[WaveformStore.cs]")]
end

subgraph group_remote["Remote control"]
  node_remotehost["HTTP and WebSocket host<br/>[RemoteHost.cs]"]
  node_codec["Remote command codec<br/>[CommandCodec.cs]"]
  node_browser["Browser remote<br/>[app.js]"]
end

node_operator(("Sound operator"))
node_lan(("LAN operator"))

node_operator -.->|"manages tracks"| node_projects
node_operator -.->|"queues playback"| node_queue
node_operator -.->|"controls show"| node_transport
node_operator -.->|"edits runlist"| node_scripts
node_operator -.->|"configures show"| node_settings
node_app -->|"starts runtime"| node_host
node_app -->|"composes"| node_queue
node_app -->|"composes"| node_scripts
node_app -->|"composes"| node_remoteui
node_queue -->|"submits commands"| node_commands
node_scripts -->|"submits commands"| node_commands
node_transport -.->|"submits commands"| node_commands
node_settings -.->|"submits settings"| node_commands
node_host -->|"creates"| node_bus
node_host -->|"creates"| node_controller
node_host -->|"creates"| node_audioengine
node_host -->|"starts autosave"| node_autosave
node_host -.->|"creates store"| node_library
node_host -->|"starts remote"| node_remotehost
node_bus -.->|"dispatches commands"| node_controller
node_controller -->|"drives playback"| node_audioengine
node_controller -->|"updates show"| node_showstate
node_controller -->|"handles commands"| node_commands
node_audioengine -->|"renders streams"| node_mixer
node_audioengine -->|"pumps sessions"| node_sessionmixer
node_audioengine -->|"opens sources"| node_sourcefactory
node_audioengine -->|"writes audio"| node_audioout
node_audioout -.->|"uses native backend"| node_shim
node_host -.->|"configures cache"| node_waveforms
node_autosave -.->|"persists snapshots"| node_snapshot
node_lan -.->|"uses browser"| node_browser
node_browser -.->|"sends remote commands"| node_remotehost
node_remotehost -.->|"decodes commands"| node_codec
node_remotehost -.->|"submits commands"| node_bus
node_remoteui -.->|"shows remote access"| node_browser

click node_app "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.App/App.axaml.cs"
click node_projects "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.App/ViewModels/PlaylistsViewModel.cs"
click node_queue "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.App/ViewModels/QueueViewModel.cs"
click node_transport "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.App/ViewModels/TransportViewModel.cs"
click node_scripts "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.App/ViewModels/ScriptPanelViewModel.cs"
click node_settings "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.App/ViewModels/SettingsViewModel.cs"
click node_host "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.App/AppHost.cs"
click node_commands "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Core/Commands/Commands.cs"
click node_bus "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Core/Runtime/CommandBus.cs"
click node_controller "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Core/Runtime/ShowController.cs"
click node_showstate "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Core/Model/Track.cs"
click node_audioengine "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Audio/AriaAudioEngine.cs"
click node_mixer "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Audio/MixerBus.cs"
click node_sessionmixer "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Audio/SessionMixer.cs"
click node_sourcefactory "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Audio/MiniaudioSourceFactory.cs"
click node_audioout "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Audio/MiniaudioSink.cs"
click node_shim "https://github.com/vladislavsaltanov/aria/blob/main/native/aria-shim/aria_shim.c"
click node_library "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Persistence/LibraryStore.cs"
click node_autosave "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Persistence/ShowAutosaver.cs"
click node_snapshot "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Persistence/SnapshotStore.cs"
click node_waveforms "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Persistence/WaveformStore.cs"
click node_remoteui "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.App/ViewModels/RemotePanelViewModel.cs"
click node_remotehost "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Remote/RemoteHost.cs"
click node_codec "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Remote/CommandCodec.cs"
click node_browser "https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Remote/RemoteClient/app.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_app,node_projects,node_queue,node_transport,node_scripts,node_settings,node_remoteui toneBlue
class node_host,node_commands,node_bus,node_controller,node_showstate toneAmber
class node_audioengine,node_mixer,node_sessionmixer,node_sourcefactory,node_audioout,node_shim toneMint
class node_library,node_autosave,node_snapshot,node_waveforms toneRose
class node_remotehost,node_codec,node_browser,node_operator,node_lan toneIndigo
```

## Components

### Desktop operation

- [App composition](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.App/App.axaml.cs): `src/ARIA.App/App.axaml.cs`
- [Projects and tracks](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.App/ViewModels/PlaylistsViewModel.cs): `src/ARIA.App/ViewModels/PlaylistsViewModel.cs`
- [Queue controls](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.App/ViewModels/QueueViewModel.cs): `src/ARIA.App/ViewModels/QueueViewModel.cs`
- [Transport controls](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.App/ViewModels/TransportViewModel.cs): `src/ARIA.App/ViewModels/TransportViewModel.cs`
- [Script panel](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.App/ViewModels/ScriptPanelViewModel.cs): `src/ARIA.App/ViewModels/ScriptPanelViewModel.cs`
- [Show settings](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.App/ViewModels/SettingsViewModel.cs): `src/ARIA.App/ViewModels/SettingsViewModel.cs`
- [Remote panel](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.App/ViewModels/RemotePanelViewModel.cs): `src/ARIA.App/ViewModels/RemotePanelViewModel.cs`

### Show control

- [Runtime host](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.App/AppHost.cs): `src/ARIA.App/AppHost.cs`
- [Command types](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Core/Commands/Commands.cs): `src/ARIA.Core/Commands/Commands.cs`
- [Command bus](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Core/Runtime/CommandBus.cs): `src/ARIA.Core/Runtime/CommandBus.cs`
- [Show controller](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Core/Runtime/ShowController.cs): `src/ARIA.Core/Runtime/ShowController.cs`
- [Show and track model](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Core/Model/Track.cs): `src/ARIA.Core/Model/Track.cs`

### Audio engine

- [Audio engine](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Audio/AriaAudioEngine.cs): `src/ARIA.Audio/AriaAudioEngine.cs`
- [Mixer bus](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Audio/MixerBus.cs): `src/ARIA.Audio/MixerBus.cs`
- [Listen sessions](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Audio/SessionMixer.cs): `src/ARIA.Audio/SessionMixer.cs`
- [Track decoding](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Audio/MiniaudioSourceFactory.cs): `src/ARIA.Audio/MiniaudioSourceFactory.cs`
- [Device output](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Audio/MiniaudioSink.cs): `src/ARIA.Audio/MiniaudioSink.cs`
- [Native audio shim](https://github.com/vladislavsaltanov/aria/blob/main/native/aria-shim/aria_shim.c): `native/aria-shim/aria_shim.c`

### Library and recovery

- [Track library](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Persistence/LibraryStore.cs): `src/ARIA.Persistence/LibraryStore.cs`
- [Show autosave](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Persistence/ShowAutosaver.cs): `src/ARIA.Persistence/ShowAutosaver.cs`
- [Show snapshots](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Persistence/SnapshotStore.cs): `src/ARIA.Persistence/SnapshotStore.cs`
- [Waveform cache](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Persistence/WaveformStore.cs): `src/ARIA.Persistence/WaveformStore.cs`

### Remote control

- [HTTP and WebSocket host](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Remote/RemoteHost.cs): `src/ARIA.Remote/RemoteHost.cs`
- [Remote command codec](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Remote/CommandCodec.cs): `src/ARIA.Remote/CommandCodec.cs`
- [Browser remote](https://github.com/vladislavsaltanov/aria/blob/main/src/ARIA.Remote/RemoteClient/app.js): `src/ARIA.Remote/RemoteClient/app.js`

### Other components

- **Sound operator**
- **LAN operator**

## Connections

- Sound operator → Projects and tracks: manages tracks (evidence: `README.md`)
- Sound operator → Queue controls: queues playback (evidence: `README.md`)
- Sound operator → Transport controls: controls show (evidence: `README.md`)
- Sound operator → Script panel: edits runlist (evidence: `README.md`)
- Sound operator → Show settings: configures show (evidence: `README.md`)
- App composition → Runtime host: starts runtime (evidence: `src/ARIA.App/App.axaml.cs`)
- App composition → Queue controls: composes (evidence: `src/ARIA.App/App.axaml.cs`)
- App composition → Script panel: composes (evidence: `src/ARIA.App/App.axaml.cs`)
- App composition → Remote panel: composes (evidence: `src/ARIA.App/App.axaml.cs`)
- Queue controls → Command types: submits commands (evidence: `src/ARIA.App/ViewModels/QueueViewModel.cs`)
- Script panel → Command types: submits commands (evidence: `src/ARIA.App/ViewModels/ScriptPanelViewModel.cs`)
- Transport controls → Command types: submits commands
- Show settings → Command types: submits settings
- Runtime host → Command bus: creates (evidence: `src/ARIA.App/AppHost.cs`)
- Runtime host → Show controller: creates (evidence: `src/ARIA.App/AppHost.cs`)
- Runtime host → Audio engine: creates (evidence: `src/ARIA.App/AppHost.cs`)
- Runtime host → Show autosave: starts autosave (evidence: `src/ARIA.App/AppHost.cs`)
- Runtime host → Track library: creates store
- Runtime host → HTTP and WebSocket host: starts remote (evidence: `src/ARIA.App/AppHost.cs`)
- Command bus → Show controller: dispatches commands
- Show controller → Audio engine: drives playback (evidence: `src/ARIA.Core/Runtime/ShowController.cs`)
- Show controller → Show and track model: updates show (evidence: `src/ARIA.Core/Runtime/ShowController.cs`)
- Show controller → Command types: handles commands (evidence: `src/ARIA.Core/Runtime/ShowController.cs`)
- Audio engine → Mixer bus: renders streams (evidence: `src/ARIA.Audio/AriaAudioEngine.cs`)
- Audio engine → Listen sessions: pumps sessions (evidence: `src/ARIA.Audio/AriaAudioEngine.cs`)
- Audio engine → Track decoding: opens sources (evidence: `src/ARIA.Audio/AriaAudioEngine.cs`)
- Audio engine → Device output: writes audio (evidence: `src/ARIA.Audio/AriaAudioEngine.cs`)
- Device output → Native audio shim: uses native backend
- Runtime host → Waveform cache: configures cache
- Show autosave → Show snapshots: persists snapshots
- LAN operator → Browser remote: uses browser (evidence: `README.md`)
- Browser remote → HTTP and WebSocket host: sends remote commands (evidence: `README.md`)
- HTTP and WebSocket host → Remote command codec: decodes commands
- HTTP and WebSocket host → Command bus: submits commands
- Remote panel → Browser remote: shows remote access (evidence: `README.md`)
