How maxrave-dev/simpmusic works
SimpMusic is a Compose Multiplatform YouTube Music client for Android and desktop. Users browse or search music, choose tracks or playlists, and play them with background playback; lyrics, audio effects, and offline support extend that experience. Separate capabilities include library and playlist management, listening analytics and recaps, and social or service integrations. The graph combines README-documented capabilities with the sampled entry-point, platform, and integration source; unsampled implementation wiring is shown only where the tree or README supports the subsystem, not as a verified call chain.
Main entry points: MainActivity.kt Playback service · FullscreenDestination.kt Now playing · App.kt Shared app UI · Main.kt Desktop host
Components 25
App entry
- Android host
androidApp/src/main/java/com/maxrave/simpmusic/MainActivity.kt - Desktop host
desktopApp/src/jvmMain/kotlin/com/maxrave/simpmusic/Main.kt - Shared app UI
composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/App.kt - Navigation
composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/graph - View models
composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/di/ViewModelModule.kt
Music experience
- Playback service
androidApp/src/main/java/com/maxrave/simpmusic/MainActivity.kt - Music discovery
composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination - Search
composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/search/SearchDestination.kt - Now playing
composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/player/FullscreenDestination.kt - Lyrics
composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/component/LyricsView.kt - Audio effects
composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/screen/home/EqualizerSection.kt - Library
composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/library/LibraryDestination.kt - Offline playback
composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/library
Personal features
- Listening analytics
composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/home/AnalyticsDestination.kt - Wrapped recaps
composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/home/WrappedDestination.kt - Home widgets
androidApp/src/main/java/com/maxrave/simpmusic/ui/widget
Integrations
- YouTube Music
- Lyrics sources
- Last.fm client
lastfm/src/commonMain/kotlin/org/simpmusic/lastfm/LastfmClient.kt - Last.fm
- Cast support
cast/src/main/java/org/simpmusic/cast/Cast.kt - Cast service
- SponsorBlock
- Return YouTube Dislike
Other components
- Listener
Connections 23
- Listener → Android host: launches
- Listener → Desktop host: launches
- Android host → Shared app UI: hosts
- Desktop host → Shared app UI: launches
- Shared app UI → Navigation: navigates
- Shared app UI → View models: uses
- Android host → Playback service: starts service
- Music discovery → YouTube Music: fetches catalog
- Search → YouTube Music: searches
- Now playing → Playback service: controls playback
- Playback service → YouTube Music: streams audio
- Now playing → Lyrics: shows lyrics
- Lyrics → Lyrics sources: loads lyrics
- Now playing → Audio effects: offers effects
- Library → Offline playback: supports downloads
- Listening analytics → Wrapped recaps: recaps listening
- Home widgets → Playback service: controls playback
- Playback service → Last.fm client: scrobbles plays
- Last.fm client → Last.fm: posts requests
- Now playing → Cast support: offers casting
- Cast support → Cast service: dispatches playback
- Playback service → SponsorBlock: checks segments
- Playback service → Return YouTube Dislike: gets vote data