# esdrasstm/volum architecture

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

## Overview

Volum is a Windows system-tray volume mixer built with WinForms/WebView2 and a C# audio layer. The main workflow is opening the tray mixer, reading live audio state, and controlling app or system volume through its web interface. Settings, the optional on-screen island, productivity and device features, and update mechanisms are distinct product branches. The graph uses README statements and shown excerpts; some internal links are omitted where the excerpts establish references but not runtime calls.

Main entry points: [`LeveMixerWeb/Island.cs`](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/Island.cs) (Dynamic island), [`LeveMixerWeb/SettingsForm.cs`](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/SettingsForm.cs) (Settings window), [`LeveMixerWeb/TrayController.cs`](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/TrayController.cs) (Tray controller), [`LeveMixerWeb/MixerForm.cs`](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/MixerForm.cs) (Mixer window)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["App lifecycle"]
  node_tray["Tray controller<br/>[TrayController.cs]"]
  node_program["App startup<br/>[Program.cs]"]
end

subgraph group_mixer["Audio mixer"]
  node_mixerform["Mixer window<br/>[MixerForm.cs]"]
  node_audio["Audio service<br/>[AudioService.cs]"]
  node_devices["Audio devices<br/>[Devices.cs]"]
  node_webui["Mixer interface<br/>[app.js]"]
end

subgraph group_settings["Settings and interface"]
  node_settingsform["Settings window<br/>[SettingsForm.cs]"]
  node_settingsui["Settings interface<br/>[settings.js]"]
  node_settings[("Persisted settings<br/>[Settings.cs]")]
end

subgraph group_island["Island features"]
  node_island["Dynamic island<br/>[Island.cs]"]
  node_focus["Focus and breaks<br/>[Focus.cs]"]
  node_water["Water reminders<br/>[Water.cs]"]
  node_agenda["Agenda<br/>[Agenda.cs]"]
  node_weather["Weather<br/>[Weather.cs]"]
  node_media["Media controls<br/>[Media.cs]"]
end

subgraph group_updates["Updates"]
  node_updater["Auto updater<br/>[Updater.cs]"]
  node_storeupdate["Store updates<br/>[StoreUpdate.cs]"]
  node_updateui["Update notice<br/>[UpdateNotice.cs]"]
end

node_user(("User"))
node_windowsaudio{{"Windows audio"}}
node_store{{"Microsoft Store"}}
node_github{{"GitHub Releases"}}

node_user -->|"opens mixer"| node_tray
node_program -->|"starts"| node_tray
node_tray -->|"opens and toggles"| node_mixerform
node_mixerform -->|"reads audio state"| node_audio
node_audio -->|"queries and controls"| node_windowsaudio
node_audio -->|"uses device data"| node_devices
node_mixerform -->|"hosts interface"| node_webui
node_webui -.->|"sends controls"| node_mixerform
node_user -.->|"opens settings"| node_settingsform
node_settingsform -.->|"hosts interface"| node_settingsui
node_settingsform -->|"configures reminders"| node_water
node_settingsform -->|"checks updates"| node_updater
node_island -.->|"uses focus features"| node_focus
node_island -.->|"uses agenda data"| node_agenda
node_island -.->|"uses weather data"| node_weather
node_island -.->|"shows devices"| node_devices
node_island -->|"shows reminders"| node_water
node_island -.->|"offers media controls"| node_media
node_tray -->|"starts automatic updates"| node_updater
node_updater -->|"checks releases"| node_github
node_settingsform -->|"checks Store updates"| node_storeupdate
node_storeupdate -->|"checks and installs"| node_store
node_storeupdate -->|"shows update notice"| node_updateui

click node_tray "https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/TrayController.cs"
click node_program "https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/Program.cs"
click node_mixerform "https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/MixerForm.cs"
click node_audio "https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/AudioService.cs"
click node_devices "https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/Devices.cs"
click node_webui "https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/wwwroot/app.js"
click node_settingsform "https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/SettingsForm.cs"
click node_settingsui "https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/wwwroot/settings.js"
click node_settings "https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/Settings.cs"
click node_island "https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/Island.cs"
click node_focus "https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/Focus.cs"
click node_water "https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/Water.cs"
click node_agenda "https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/Agenda.cs"
click node_weather "https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/Weather.cs"
click node_media "https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/Media.cs"
click node_updater "https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/Updater.cs"
click node_storeupdate "https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/StoreUpdate.cs"
click node_updateui "https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/UpdateNotice.cs"

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_tray,node_program,node_user toneBlue
class node_mixerform,node_audio,node_devices,node_webui toneAmber
class node_settingsform,node_settingsui,node_settings toneMint
class node_island,node_focus,node_water,node_agenda,node_weather,node_media toneRose
class node_updater,node_storeupdate,node_updateui,node_windowsaudio,node_store,node_github toneIndigo
```

## Components

### App lifecycle

- [Tray controller](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/TrayController.cs): `LeveMixerWeb/TrayController.cs`
- [App startup](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/Program.cs): `LeveMixerWeb/Program.cs`

### Audio mixer

- [Mixer window](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/MixerForm.cs): `LeveMixerWeb/MixerForm.cs`
- [Audio service](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/AudioService.cs): `LeveMixerWeb/AudioService.cs`
- [Audio devices](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/Devices.cs): `LeveMixerWeb/Devices.cs`
- [Mixer interface](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/wwwroot/app.js): `LeveMixerWeb/wwwroot/app.js`

### Settings and interface

- [Settings window](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/SettingsForm.cs): `LeveMixerWeb/SettingsForm.cs`
- [Settings interface](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/wwwroot/settings.js): `LeveMixerWeb/wwwroot/settings.js`
- [Persisted settings](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/Settings.cs): `LeveMixerWeb/Settings.cs`

### Island features

- [Dynamic island](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/Island.cs): `LeveMixerWeb/Island.cs`
- [Focus and breaks](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/Focus.cs): `LeveMixerWeb/Focus.cs`
- [Water reminders](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/Water.cs): `LeveMixerWeb/Water.cs`
- [Agenda](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/Agenda.cs): `LeveMixerWeb/Agenda.cs`
- [Weather](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/Weather.cs): `LeveMixerWeb/Weather.cs`
- [Media controls](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/Media.cs): `LeveMixerWeb/Media.cs`

### Updates

- [Auto updater](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/Updater.cs): `LeveMixerWeb/Updater.cs`
- [Store updates](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/StoreUpdate.cs): `LeveMixerWeb/StoreUpdate.cs`
- [Update notice](https://github.com/esdrasstm/volum/blob/main/LeveMixerWeb/UpdateNotice.cs): `LeveMixerWeb/UpdateNotice.cs`

### Other components

- **User**
- **Windows audio**
- **Microsoft Store**
- **GitHub Releases**

## Connections

- User → Tray controller: opens mixer (evidence: `README.md`)
- App startup → Tray controller: starts (evidence: `LeveMixerWeb/Program.cs`)
- Tray controller → Mixer window: opens and toggles (evidence: `LeveMixerWeb/TrayController.cs`)
- Mixer window → Audio service: reads audio state (evidence: `LeveMixerWeb/MixerForm.cs`)
- Audio service → Windows audio: queries and controls (evidence: `LeveMixerWeb/AudioService.cs`)
- Audio service → Audio devices: uses device data (evidence: `LeveMixerWeb/AudioService.cs`)
- Mixer window → Mixer interface: hosts interface (evidence: `README.md`)
- Mixer interface → Mixer window: sends controls
- User → Settings window: opens settings
- Settings window → Settings interface: hosts interface
- Settings window → Water reminders: configures reminders (evidence: `LeveMixerWeb/SettingsForm.cs`)
- Settings window → Auto updater: checks updates (evidence: `LeveMixerWeb/SettingsForm.cs`)
- Dynamic island → Focus and breaks: uses focus features (evidence: `LeveMixerWeb/Island.cs`)
- Dynamic island → Agenda: uses agenda data (evidence: `LeveMixerWeb/Island.cs`)
- Dynamic island → Weather: uses weather data (evidence: `LeveMixerWeb/Island.cs`)
- Dynamic island → Audio devices: shows devices (evidence: `LeveMixerWeb/Island.cs`)
- Dynamic island → Water reminders: shows reminders (evidence: `LeveMixerWeb/Water.cs`)
- Dynamic island → Media controls: offers media controls
- Tray controller → Auto updater: starts automatic updates (evidence: `LeveMixerWeb/TrayController.cs`)
- Auto updater → GitHub Releases: checks releases (evidence: `LeveMixerWeb/Updater.cs`)
- Settings window → Store updates: checks Store updates (evidence: `LeveMixerWeb/SettingsForm.cs`)
- Store updates → Microsoft Store: checks and installs (evidence: `LeveMixerWeb/StoreUpdate.cs`)
- Store updates → Update notice: shows update notice (evidence: `LeveMixerWeb/StoreUpdate.cs`)
