How tk88101/azathoths-whisper works
Azathoth’s Whisper is a macOS SwiftUI app that monitors Music.app, fetches lyrics for the playing track, and embeds them in its audio-file metadata. Its user workflow runs from track detection through lyrics lookup and write-back; the editor and batch-import flows use different lookup policies. The app also provides queue-aware lyrics and a display-only Cover Flow, artwork caching, settings, and localization. Edges are limited to relationships supported by the README or SOURCE INDEX references; unsampled implementation details are not inferred.
Main entry points: AppModel.swift App coordinator · RootView.swift App interface · MusicControlling.swift Music interface · ArtworkService.swift Artwork service
Components 27
App workflow
- App coordinator
AzathothsWhisper/App/AppModel.swift - Lyrics editor
AzathothsWhisper/Features/Editor/EditorViewModel.swift - Batch import
AzathothsWhisper/Features/Batch/BatchViewModel.swift - Queue lyrics
AzathothsWhisper/Features/LyricsFlow/LyricsFlowModel.swift - Deck snapshot
AzathothsWhisper/Features/LyricsFlow/DeckSnapshot.swift - Queue session
AzathothsWhisper/Features/LyricsFlow/QueueSession.swift - Cover Flow state
AzathothsWhisper/Features/CoverFlow/CoverFlowViewModel.swift
Lyrics lookup
- Lyrics routing
AzathothsWhisper/Services/Lyrics/LyricsService.swift - Genius source
AzathothsWhisper/Services/Lyrics/GeniusSource.swift - DarkLyrics source
AzathothsWhisper/Services/Lyrics/DarkLyricsSource.swift - HTTP client
AzathothsWhisper/Infra/HTTPClient.swift
Music integration
- Track monitor
AzathothsWhisper/Services/Music/NowPlayingMonitor.swift - Apple Events client
AzathothsWhisper/Services/Music/MusicAppleEventsClient.swift - Music interface
AzathothsWhisper/Services/Music/MusicControlling.swift - Artwork service
AzathothsWhisper/Services/Artwork/ArtworkService.swift - Memory cache
AzathothsWhisper/Services/Artwork/ArtworkMemoryCache.swift - Disk cache
AzathothsWhisper/Services/Artwork/ArtworkDiskCache.swift
User experience
- App interface
AzathothsWhisper/Features/Shell/RootView.swift - Batch screen
AzathothsWhisper/Features/Batch/BatchView.swift - Lyrics screen
AzathothsWhisper/Features/LyricsFlow/LyricsFlowPageView.swift
Settings and assets
- Settings state
AzathothsWhisper/Features/Settings/SettingsViewModel.swift - Configuration
AzathothsWhisper/Services/Config/ConfigStore.swift - Language manager
AzathothsWhisper/Services/Config/LanguageManager.swift
Other components
- User
- Music.app
- Genius API
- DarkLyrics
Connections 35
- User → App interface: uses
AzathothsWhisper/Features/Shell/RootView.swift - App interface → App coordinator: binds state
AzathothsWhisper/Features/Shell/RootView.swift - App interface → Batch screen: shows
AzathothsWhisper/Features/Shell/RootView.swift - App interface → Lyrics screen: shows
AzathothsWhisper/Features/Shell/RootView.swift - App coordinator → Track monitor: starts and refreshes
AzathothsWhisper/App/AppModel.swift - Track monitor → Apple Events client: reads playback
- Apple Events client → Music interface: implements
AzathothsWhisper/Services/Music/MusicAppleEventsClient.swift - Apple Events client → Music.app: sends Apple Events
AzathothsWhisper/Services/Music/MusicAppleEventsClient.swift - App coordinator → Lyrics editor: creates
AzathothsWhisper/App/AppModel.swift - App coordinator → Batch import: creates
AzathothsWhisper/App/AppModel.swift - App coordinator → Queue lyrics: creates and starts
AzathothsWhisper/App/AppModel.swift - App coordinator → Settings state: creates
AzathothsWhisper/App/AppModel.swift - Lyrics editor → Lyrics routing: fetches lyrics
AzathothsWhisper/Features/Editor/EditorViewModel.swift - Batch import → Lyrics routing: fetches missing lyrics
AzathothsWhisper/Features/Batch/BatchViewModel.swift - Lyrics editor → Music interface: reads and writes lyrics
AzathothsWhisper/Features/Editor/EditorViewModel.swift - Batch import → Music interface: loads and imports tracks
AzathothsWhisper/Features/Batch/BatchViewModel.swift - Lyrics routing → Genius source: queries first
AzathothsWhisper/Services/Lyrics/LyricsService.swift - Lyrics routing → DarkLyrics source: batch fallback
AzathothsWhisper/Services/Lyrics/LyricsService.swift - Genius source → HTTP client: uses HTTP
- DarkLyrics source → HTTP client: uses HTTP
- Genius source → Genius API: queries
- DarkLyrics source → DarkLyrics: queries
- Queue lyrics → Music interface: reads queue and playback
- Queue lyrics → Deck snapshot: builds deck
AzathothsWhisper/Features/LyricsFlow/LyricsFlowModel.swift - Deck snapshot → Queue session: uses queue session
AzathothsWhisper/Features/LyricsFlow/QueueSession.swift - Cover Flow state → Queue lyrics: gets deck state
AzathothsWhisper/Features/CoverFlow/CoverFlowViewModel.swift - App coordinator → Cover Flow state: creates
AzathothsWhisper/App/AppModel.swift - Cover Flow state → Artwork service: loads and prefetches
AzathothsWhisper/Features/CoverFlow/CoverFlowViewModel.swift - Artwork service → Music interface: fetches artwork
AzathothsWhisper/Services/Artwork/ArtworkService.swift - Artwork service → Memory cache: checks cache
AzathothsWhisper/Services/Artwork/ArtworkService.swift - Artwork service → Disk cache: loads and stores
AzathothsWhisper/Services/Artwork/ArtworkService.swift - Settings state → Configuration: reads and saves
- Settings state → Language manager: manages language
- App coordinator → Configuration: configures services
AzathothsWhisper/App/AppModel.swift - Settings state → App interface: presents settings
AzathothsWhisper/Features/Shell/RootView.swift