# vincentneo/losslessswitcher architecture

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

- Interactive diagram: https://gitdiagram.com/vincentneo/losslessswitcher
- Repository: https://github.com/vincentneo/losslessswitcher

## Overview

LosslessSwitcher is a macOS menu-bar app that detects the playing Apple Music track’s audio format and adjusts the selected output device to match. Its main workflow receives track changes, inspects recent audio logs, chooses a supported device format, and updates the displayed sample rate; optional bit-depth detection and user scripts extend that flow. The menu also exposes device selection and persistent preferences. The graph reflects the sampled call sites and README capabilities; some parser and device-format details are only partially excerpted, so uncertain links are omitted.

Main entry points: [`Quality/OutputDevices.swift`](https://github.com/vincentneo/losslessswitcher/blob/main/Quality/OutputDevices.swift) (Format detection and switching), [`Quality/QualityApp.swift`](https://github.com/vincentneo/losslessswitcher/blob/main/Quality/QualityApp.swift) (App entry point), [`Quality/AppDelegate.swift`](https://github.com/vincentneo/losslessswitcher/blob/main/Quality/AppDelegate.swift) (App delegate), [`Quality/MenuView.swift`](https://github.com/vincentneo/losslessswitcher/blob/main/Quality/MenuView.swift) (Menu and settings UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lifecycle["App lifecycle"]
  node_qualityapp["App entry point<br/>[QualityApp.swift]"]
  node_appdelegate["App delegate<br/>[AppDelegate.swift]"]
  node_menubarcontroller["Menu controller"]
end

subgraph group_detection["Track and format detection"]
  node_mediaremote["Track listener"]
  node_mediatrack["Track model<br/>[MediaTrack.swift]"]
  node_console["Log reader<br/>[Console.swift]"]
  node_parser["Audio log parser"]
end

subgraph group_audio["Audio device control"]
  node_outputdevices["Format detection and switching"]
end

subgraph group_interface["Menu bar interface"]
  node_contentview["Device status view<br/>[ContentView.swift]"]
  node_menuview["Menu and settings UI<br/>[MenuView.swift]"]
  node_samplelabel["Status rate label"]
  node_deviceitem["Device menu item"]
end

subgraph group_preferences["Preferences and actions"]
  node_defaults[("Saved preferences<br/>[Defaults.swift]")]
end

node_user(("User"))
node_music["Apple Music"]
node_oslogs[("macOS audio logs")]
node_coreaudio["Core Audio devices"]
node_script["User script"]

node_qualityapp -->|"adapts lifecycle"| node_appdelegate
node_qualityapp -->|"creates controller"| node_menubarcontroller
node_qualityapp -->|"shows menu"| node_menuview
node_qualityapp -->|"shows rate"| node_samplelabel
node_qualityapp -->|"reads preferences"| node_defaults
node_appdelegate -->|"creates device state"| node_outputdevices
node_appdelegate -->|"starts listener"| node_mediaremote
node_appdelegate -->|"reads preferences"| node_defaults
node_menubarcontroller -->|"creates device state"| node_outputdevices
node_menubarcontroller -->|"starts listener"| node_mediaremote
node_mediaremote -->|"delivers track changes"| node_outputdevices
node_mediaremote -->|"listens for tracks"| node_music
node_outputdevices -->|"reads recent logs"| node_console
node_outputdevices -->|"parses audio stats"| node_parser
node_console -->|"queries entries"| node_oslogs
node_outputdevices -->|"reads and sets formats"| node_coreaudio
node_outputdevices -->|"reads switching options"| node_defaults
node_outputdevices -->|"runs on change"| node_script
node_menuview -->|"renders status"| node_contentview
node_menuview -->|"updates preferences"| node_defaults
node_menuview -->|"selects device"| node_outputdevices
node_contentview -->|"displays device state"| node_outputdevices
node_samplelabel -->|"displays sample rate"| node_outputdevices
node_appdelegate -->|"builds device choices"| node_deviceitem
node_user -->|"chooses options"| node_menuview

click node_qualityapp "https://github.com/vincentneo/losslessswitcher/blob/main/Quality/QualityApp.swift"
click node_appdelegate "https://github.com/vincentneo/losslessswitcher/blob/main/Quality/AppDelegate.swift"
click node_menubarcontroller "https://github.com/vincentneo/losslessswitcher/blob/main/Quality/MenuBarController.swift"
click node_mediaremote "https://github.com/vincentneo/losslessswitcher/blob/main/Quality/MediaRemoteController.swift"
click node_mediatrack "https://github.com/vincentneo/losslessswitcher/blob/main/Quality/MediaTrack.swift"
click node_console "https://github.com/vincentneo/losslessswitcher/blob/main/Quality/Console.swift"
click node_parser "https://github.com/vincentneo/losslessswitcher/blob/main/Quality/CMPlayerStuff.swift"
click node_outputdevices "https://github.com/vincentneo/losslessswitcher/blob/main/Quality/OutputDevices.swift"
click node_contentview "https://github.com/vincentneo/losslessswitcher/blob/main/Quality/ContentView.swift"
click node_menuview "https://github.com/vincentneo/losslessswitcher/blob/main/Quality/MenuView.swift"
click node_samplelabel "https://github.com/vincentneo/losslessswitcher/blob/main/Quality/SampleRateLabel.swift"
click node_deviceitem "https://github.com/vincentneo/losslessswitcher/blob/main/Quality/DeviceMenuItem.swift"
click node_defaults "https://github.com/vincentneo/losslessswitcher/blob/main/Quality/Defaults.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_qualityapp,node_appdelegate,node_menubarcontroller,node_user,node_script toneBlue
class node_mediaremote,node_mediatrack,node_console,node_parser,node_oslogs toneAmber
class node_outputdevices toneMint
class node_contentview,node_menuview,node_samplelabel,node_deviceitem toneRose
class node_defaults,node_music,node_coreaudio toneIndigo
```

## Components

### App lifecycle

- [App entry point](https://github.com/vincentneo/losslessswitcher/blob/main/Quality/QualityApp.swift): `Quality/QualityApp.swift`
- [App delegate](https://github.com/vincentneo/losslessswitcher/blob/main/Quality/AppDelegate.swift): `Quality/AppDelegate.swift`
- [Menu controller](https://github.com/vincentneo/losslessswitcher/blob/main/Quality/MenuBarController.swift): `Quality/MenuBarController.swift`

### Track and format detection

- [Track listener](https://github.com/vincentneo/losslessswitcher/blob/main/Quality/MediaRemoteController.swift): `Quality/MediaRemoteController.swift`
- [Track model](https://github.com/vincentneo/losslessswitcher/blob/main/Quality/MediaTrack.swift): `Quality/MediaTrack.swift`
- [Log reader](https://github.com/vincentneo/losslessswitcher/blob/main/Quality/Console.swift): `Quality/Console.swift`
- [Audio log parser](https://github.com/vincentneo/losslessswitcher/blob/main/Quality/CMPlayerStuff.swift): `Quality/CMPlayerStuff.swift`

### Audio device control

- [Format detection and switching](https://github.com/vincentneo/losslessswitcher/blob/main/Quality/OutputDevices.swift): `Quality/OutputDevices.swift`

### Menu bar interface

- [Device status view](https://github.com/vincentneo/losslessswitcher/blob/main/Quality/ContentView.swift): `Quality/ContentView.swift`
- [Menu and settings UI](https://github.com/vincentneo/losslessswitcher/blob/main/Quality/MenuView.swift): `Quality/MenuView.swift`
- [Status rate label](https://github.com/vincentneo/losslessswitcher/blob/main/Quality/SampleRateLabel.swift): `Quality/SampleRateLabel.swift`
- [Device menu item](https://github.com/vincentneo/losslessswitcher/blob/main/Quality/DeviceMenuItem.swift): `Quality/DeviceMenuItem.swift`

### Preferences and actions

- [Saved preferences](https://github.com/vincentneo/losslessswitcher/blob/main/Quality/Defaults.swift): `Quality/Defaults.swift`

### Other components

- **User**
- **Apple Music**
- **macOS audio logs**
- **Core Audio devices**
- **User script**

## Connections

- App entry point → App delegate: adapts lifecycle (evidence: `Quality/QualityApp.swift`)
- App entry point → Menu controller: creates controller (evidence: `Quality/QualityApp.swift`)
- App entry point → Menu and settings UI: shows menu (evidence: `Quality/QualityApp.swift`)
- App entry point → Status rate label: shows rate (evidence: `Quality/QualityApp.swift`)
- App entry point → Saved preferences: reads preferences (evidence: `Quality/QualityApp.swift`)
- App delegate → Format detection and switching: creates device state (evidence: `Quality/AppDelegate.swift`)
- App delegate → Track listener: starts listener (evidence: `Quality/AppDelegate.swift`)
- App delegate → Saved preferences: reads preferences (evidence: `Quality/AppDelegate.swift`)
- Menu controller → Format detection and switching: creates device state (evidence: `Quality/MenuBarController.swift`)
- Menu controller → Track listener: starts listener (evidence: `Quality/MenuBarController.swift`)
- Track listener → Format detection and switching: delivers track changes (evidence: `Quality/MediaRemoteController.swift`)
- Track listener → Apple Music: listens for tracks (evidence: `README.md`)
- Format detection and switching → Log reader: reads recent logs (evidence: `Quality/OutputDevices.swift`)
- Format detection and switching → Audio log parser: parses audio stats (evidence: `Quality/OutputDevices.swift`)
- Log reader → macOS audio logs: queries entries (evidence: `Quality/Console.swift`)
- Format detection and switching → Core Audio devices: reads and sets formats (evidence: `README.md`)
- Format detection and switching → Saved preferences: reads switching options (evidence: `Quality/OutputDevices.swift`)
- Format detection and switching → User script: runs on change (evidence: `Quality/OutputDevices.swift`)
- Menu and settings UI → Device status view: renders status (evidence: `Quality/MenuView.swift`)
- Menu and settings UI → Saved preferences: updates preferences (evidence: `Quality/MenuView.swift`)
- Menu and settings UI → Format detection and switching: selects device (evidence: `Quality/MenuView.swift`)
- Device status view → Format detection and switching: displays device state (evidence: `Quality/ContentView.swift`)
- Status rate label → Format detection and switching: displays sample rate (evidence: `Quality/SampleRateLabel.swift`)
- App delegate → Device menu item: builds device choices (evidence: `Quality/AppDelegate.swift`)
- User → Menu and settings UI: chooses options
