# barcodaniel501/perappvolume architecture

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

## Overview

PerAppVolume is a macOS menu-bar app for independently adjusting open apps’ audio, alongside system output volume. The main workflow starts when the app launches the mixer model, which scans audio processes, presents apps and their controls, and creates process taps for non-default per-app settings; users can also open a larger mixer or Settings. The README documents tap/aggregate-device audio processing, saved settings, output-device tracking, login launch, and English/Spanish localization. Some UI and helper implementations were not sampled, so only documented or indexed relationships are shown.

Main entry points: [`Sources/PerAppVolume/MixerModel.swift`](https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/MixerModel.swift) (Mixer model), [`Sources/PerAppVolume/PerAppVolumeApp.swift`](https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/PerAppVolumeApp.swift) (App lifecycle), [`Sources/PerAppVolume/Views/MenuContentView.swift`](https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Views/MenuContentView.swift) (Menu panel), [`Sources/PerAppVolume/Views/SettingsView.swift`](https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Views/SettingsView.swift) (Settings view)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App lifecycle"]
  node_entry["App entry<br/>[main.swift]"]
  node_app_lifecycle["App lifecycle"]
end

subgraph group_audio["Audio management"]
  node_mixer_model["Mixer model<br/>[MixerModel.swift]"]
  node_scanner["Process scanner"]
  node_app_tap["Per-app tap<br/>[AppTap.swift]"]
  node_coreaudio_helpers["Core Audio helpers"]
  node_system_volume["System volume<br/>[SystemVolume.swift]"]
end

subgraph group_interface["Mixer interface"]
  node_menu["Menu panel"]
  node_app_rows["App controls<br/>[AppRowView.swift]"]
  node_system_row["System controls"]
  node_mixer_window["Mixer window"]
  node_window_manager["Window manager"]
end

subgraph group_preferences["Preferences"]
  node_settings_view["Settings view<br/>[SettingsView.swift]"]
  node_login_service["Login service"]
  node_localization["Localization<br/>[Localization.swift]"]
  node_saved_settings[("Saved volumes<br/>[MixerModel.swift]")]
end

node_user(("Mac user"))
node_audio_output(("Audio output"))

node_user -->|"launches"| node_entry
node_entry -->|"starts"| node_app_lifecycle
node_app_lifecycle -->|"starts"| node_mixer_model
node_app_lifecycle -->|"starts"| node_system_volume
node_app_lifecycle -->|"presents"| node_menu
node_mixer_model -->|"scans processes"| node_scanner
node_mixer_model -->|"creates taps"| node_app_tap
node_mixer_model -->|"loads and saves"| node_saved_settings
node_entry -->|"lists processes"| node_scanner
node_user -->|"opens controls"| node_menu
node_menu -->|"opens windows"| node_window_manager
node_window_manager -->|"creates window"| node_mixer_window
node_window_manager -->|"creates window"| node_settings_view
node_menu -->|"shows controls"| node_system_row
node_mixer_window -->|"shows controls"| node_system_row
node_app_rows -->|"uses app state"| node_mixer_model
node_system_row -->|"sets volume"| node_system_volume
node_settings_view -->|"resets volumes"| node_mixer_model
node_settings_view -->|"sets login"| node_login_service
node_app_lifecycle -->|"sets first-run default"| node_login_service
node_app_tap -->|"renders adjusted audio"| node_audio_output
node_system_volume -->|"controls device volume"| node_audio_output
node_user -->|"changes preferences"| node_settings_view

click node_entry "https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/main.swift"
click node_app_lifecycle "https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/PerAppVolumeApp.swift"
click node_mixer_model "https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/MixerModel.swift"
click node_scanner "https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Audio/AudioProcessScanner.swift"
click node_app_tap "https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Audio/AppTap.swift"
click node_coreaudio_helpers "https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Audio/CoreAudioHelpers.swift"
click node_system_volume "https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Audio/SystemVolume.swift"
click node_menu "https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Views/MenuContentView.swift"
click node_app_rows "https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Views/AppRowView.swift"
click node_system_row "https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Views/SystemVolumeRow.swift"
click node_mixer_window "https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Views/MixerWindowView.swift"
click node_window_manager "https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/WindowManager.swift"
click node_settings_view "https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Views/SettingsView.swift"
click node_login_service "https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/LaunchAtLogin.swift"
click node_localization "https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Localization.swift"
click node_saved_settings "https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/MixerModel.swift"

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_entry,node_app_lifecycle,node_user toneBlue
class node_mixer_model,node_scanner,node_app_tap,node_coreaudio_helpers,node_system_volume toneAmber
class node_menu,node_app_rows,node_system_row,node_mixer_window,node_window_manager toneMint
class node_settings_view,node_login_service,node_localization,node_saved_settings toneRose
class node_audio_output toneIndigo
```

## Components

### App lifecycle

- [App entry](https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/main.swift): `Sources/PerAppVolume/main.swift`
- [App lifecycle](https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/PerAppVolumeApp.swift): `Sources/PerAppVolume/PerAppVolumeApp.swift`

### Audio management

- [Mixer model](https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/MixerModel.swift): `Sources/PerAppVolume/MixerModel.swift`
- [Process scanner](https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Audio/AudioProcessScanner.swift): `Sources/PerAppVolume/Audio/AudioProcessScanner.swift`
- [Per-app tap](https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Audio/AppTap.swift): `Sources/PerAppVolume/Audio/AppTap.swift`
- [Core Audio helpers](https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Audio/CoreAudioHelpers.swift): `Sources/PerAppVolume/Audio/CoreAudioHelpers.swift`
- [System volume](https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Audio/SystemVolume.swift): `Sources/PerAppVolume/Audio/SystemVolume.swift`

### Mixer interface

- [Menu panel](https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Views/MenuContentView.swift): `Sources/PerAppVolume/Views/MenuContentView.swift`
- [App controls](https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Views/AppRowView.swift): `Sources/PerAppVolume/Views/AppRowView.swift`
- [System controls](https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Views/SystemVolumeRow.swift): `Sources/PerAppVolume/Views/SystemVolumeRow.swift`
- [Mixer window](https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Views/MixerWindowView.swift): `Sources/PerAppVolume/Views/MixerWindowView.swift`
- [Window manager](https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/WindowManager.swift): `Sources/PerAppVolume/WindowManager.swift`

### Preferences

- [Settings view](https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Views/SettingsView.swift): `Sources/PerAppVolume/Views/SettingsView.swift`
- [Login service](https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/LaunchAtLogin.swift): `Sources/PerAppVolume/LaunchAtLogin.swift`
- [Localization](https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/Localization.swift): `Sources/PerAppVolume/Localization.swift`
- [Saved volumes](https://github.com/barcodaniel501/perappvolume/blob/main/Sources/PerAppVolume/MixerModel.swift): `Sources/PerAppVolume/MixerModel.swift`

### Other components

- **Mac user**
- **Audio output**

## Connections

- Mac user → App entry: launches (evidence: `README.md`)
- App entry → App lifecycle: starts (evidence: `Sources/PerAppVolume/main.swift`)
- App lifecycle → Mixer model: starts (evidence: `Sources/PerAppVolume/PerAppVolumeApp.swift`)
- App lifecycle → System volume: starts (evidence: `Sources/PerAppVolume/PerAppVolumeApp.swift`)
- App lifecycle → Menu panel: presents (evidence: `Sources/PerAppVolume/PerAppVolumeApp.swift`)
- Mixer model → Process scanner: scans processes (evidence: `Sources/PerAppVolume/MixerModel.swift`)
- Mixer model → Per-app tap: creates taps (evidence: `Sources/PerAppVolume/MixerModel.swift`)
- Mixer model → Saved volumes: loads and saves (evidence: `Sources/PerAppVolume/MixerModel.swift`)
- App entry → Process scanner: lists processes (evidence: `Sources/PerAppVolume/main.swift`)
- Mac user → Menu panel: opens controls (evidence: `README.md`)
- Menu panel → Window manager: opens windows (evidence: `Sources/PerAppVolume/Views/MenuContentView.swift`)
- Window manager → Mixer window: creates window (evidence: `Sources/PerAppVolume/WindowManager.swift`)
- Window manager → Settings view: creates window (evidence: `Sources/PerAppVolume/WindowManager.swift`)
- Menu panel → System controls: shows controls (evidence: `Sources/PerAppVolume/Views/MenuContentView.swift`)
- Mixer window → System controls: shows controls (evidence: `Sources/PerAppVolume/Views/MixerWindowView.swift`)
- App controls → Mixer model: uses app state (evidence: `Sources/PerAppVolume/Views/AppRowView.swift`)
- System controls → System volume: sets volume (evidence: `Sources/PerAppVolume/Views/SystemVolumeRow.swift`)
- Settings view → Mixer model: resets volumes (evidence: `Sources/PerAppVolume/Views/SettingsView.swift`)
- Settings view → Login service: sets login (evidence: `Sources/PerAppVolume/Views/SettingsView.swift`)
- App lifecycle → Login service: sets first-run default (evidence: `Sources/PerAppVolume/PerAppVolumeApp.swift`)
- Per-app tap → Audio output: renders adjusted audio (evidence: `Sources/PerAppVolume/Audio/AppTap.swift`)
- System volume → Audio output: controls device volume (evidence: `Sources/PerAppVolume/Audio/SystemVolume.swift`)
- Mac user → Settings view: changes preferences (evidence: `README.md`)
