How chenqi92/primuse works
Primuse is a native Apple-ecosystem music player that unifies local and remote music sources in a shared library and playback queue. Its principal workflow is to connect or import a source, browse or search its catalog, resolve a playable item, and play it with format-aware decoding and system controls. The product also includes radio, recommendations, lyrics and metadata tooling, synchronization, and companion experiences across Apple platforms. Several important modules are named in the source index but were not excerpted; their internals and call relationships are therefore not inferred here.
Main entry points: App.swift Primuse apps · MusicLibrary.swift Music library · MusicSource.swift Music sources · TVAudioEngine.swift TV audio engine
Components 23
Sources and library
- Music sources
PrimuseKit/Sources/PrimuseKit/Models/MusicSource.swift - Stream resolution
PrimuseKit/Sources/PrimuseKit/Streaming/StreamResolverRegistry.swift - Music library
Primuse/Services/Library/MusicLibrary.swift - Song model
PrimuseKit/Sources/PrimuseKit/Models/Song.swift - Credential storage
Primuse/Utilities/KeychainService.swift - Cloud sync
Primuse/Services/Cloud/CloudKitSyncService.swift - Apple Music
Primuse/Services/AppleMusic/AppleMusicService.swift
Playback and audio
- Audio engine
Primuse/Services/Audio/AudioEngine.swift - TV audio engine
PrimuseTV/Audio/TVAudioEngine.swift - TV format fallback
PrimuseTV/Audio/TVSFBEngine.swift - Format support
PrimuseKit/Sources/PrimuseKit/Models/AudioFormat.swift - Radio playback
Primuse/Services/Radio/RadioPlaybackController.swift
Discovery and lyrics
- Smart playlists
Primuse/Services/Library/SmartPlaylistEngine.swift - Music intelligence
Primuse/Services/AI/MusicIntelligenceService.swift - Metadata scraping
Primuse/Services/Metadata/ScraperManager.swift - Lyrics model
PrimuseKit/Sources/PrimuseKit/Models/LyricLine.swift - Lyrics translation
Primuse/Services/Lyrics/LocalLyricsTranslationEngine.swift
Apple experiences
- Primuse apps
PrimuseTV/App.swift - Watch controls
PrimuseWatch/Stores/WatchPlayerStore.swift - Now playing widgets
PrimuseWidgetExtension/NowPlayingWidget.swift - Mac desktop tools
Primuse/App/MacMenuBarController.swift - Share relay
ShareRelay/main.go
Other components
- Listener
Connections 22
- Listener → Primuse apps: uses
README.md - Primuse apps → Music sources: connects sources
README.md - Music sources → Music library: feeds catalog
README.md - Music library → Song model: stores songs
README.md - Music library → Stream resolution: resolves streams
README.md - Stream resolution → Credential storage: uses credentials
README.md - Music library → Cloud sync: syncs library
README.md - Primuse apps → Audio engine: plays audio
README.md - Primuse apps → TV audio engine: plays on TV
README.md - TV audio engine → TV format fallback: decodes fallback
PrimuseTV/Audio/TVAudioEngine.swift - TV audio engine → Format support: selects formats
- Primuse apps → Radio playback: plays radio
README.md - Music library → Smart playlists: builds playlists
Primuse/Services/Library/SmartPlaylistEngine.swift - Primuse apps → Music intelligence: offers recommendations
README.md - Primuse apps → Metadata scraping: scrapes metadata
README.md - Primuse apps → Lyrics model: displays lyrics
README.md - Lyrics model → Lyrics translation: translates lyrics
README.md - Music sources → Apple Music: includes source
README.md - Primuse apps → Watch controls: supports remote control
README.md - Primuse apps → Now playing widgets: provides widgets
README.md - Primuse apps → Mac desktop tools: offers desktop tools
README.md - Primuse apps → Share relay: supports transfer relay