How vincentneo/losslessswitcher works
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: OutputDevices.swift Format detection and switching · QualityApp.swift App entry point · AppDelegate.swift App delegate · MenuView.swift Menu and settings UI
Components 18
App lifecycle
- App entry point
Quality/QualityApp.swift - App delegate
Quality/AppDelegate.swift - Menu controller
Quality/MenuBarController.swift
Track and format detection
- Track listener
Quality/MediaRemoteController.swift - Track model
Quality/MediaTrack.swift - Log reader
Quality/Console.swift - Audio log parser
Quality/CMPlayerStuff.swift
Audio device control
- Format detection and switching
Quality/OutputDevices.swift
Menu bar interface
- Device status view
Quality/ContentView.swift - Menu and settings UI
Quality/MenuView.swift - Status rate label
Quality/SampleRateLabel.swift - Device menu item
Quality/DeviceMenuItem.swift
Preferences and actions
- Saved preferences
Quality/Defaults.swift
Other components
- User
- Apple Music
- macOS audio logs
- Core Audio devices
- User script
Connections 25
- App entry point → App delegate: adapts lifecycle
Quality/QualityApp.swift - App entry point → Menu controller: creates controller
Quality/QualityApp.swift - App entry point → Menu and settings UI: shows menu
Quality/QualityApp.swift - App entry point → Status rate label: shows rate
Quality/QualityApp.swift - App entry point → Saved preferences: reads preferences
Quality/QualityApp.swift - App delegate → Format detection and switching: creates device state
Quality/AppDelegate.swift - App delegate → Track listener: starts listener
Quality/AppDelegate.swift - App delegate → Saved preferences: reads preferences
Quality/AppDelegate.swift - Menu controller → Format detection and switching: creates device state
Quality/MenuBarController.swift - Menu controller → Track listener: starts listener
Quality/MenuBarController.swift - Track listener → Format detection and switching: delivers track changes
Quality/MediaRemoteController.swift - Track listener → Apple Music: listens for tracks
README.md - Format detection and switching → Log reader: reads recent logs
Quality/OutputDevices.swift - Format detection and switching → Audio log parser: parses audio stats
Quality/OutputDevices.swift - Log reader → macOS audio logs: queries entries
Quality/Console.swift - Format detection and switching → Core Audio devices: reads and sets formats
README.md - Format detection and switching → Saved preferences: reads switching options
Quality/OutputDevices.swift - Format detection and switching → User script: runs on change
Quality/OutputDevices.swift - Menu and settings UI → Device status view: renders status
Quality/MenuView.swift - Menu and settings UI → Saved preferences: updates preferences
Quality/MenuView.swift - Menu and settings UI → Format detection and switching: selects device
Quality/MenuView.swift - Device status view → Format detection and switching: displays device state
Quality/ContentView.swift - Status rate label → Format detection and switching: displays sample rate
Quality/SampleRateLabel.swift - App delegate → Device menu item: builds device choices
Quality/AppDelegate.swift - User → Menu and settings UI: chooses options