# maxrave-dev/simpmusic architecture

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

- Interactive diagram: https://gitdiagram.com/maxrave-dev/simpmusic
- Repository: https://github.com/maxrave-dev/simpmusic

## Overview

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: [`androidApp/src/main/java/com/maxrave/simpmusic/MainActivity.kt`](https://github.com/maxrave-dev/simpmusic/blob/dev/androidApp/src/main/java/com/maxrave/simpmusic/MainActivity.kt) (Playback service), [`composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/player/FullscreenDestination.kt`](https://github.com/maxrave-dev/simpmusic/blob/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/player/FullscreenDestination.kt) (Now playing), [`composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/App.kt`](https://github.com/maxrave-dev/simpmusic/blob/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/App.kt) (Shared app UI), [`desktopApp/src/jvmMain/kotlin/com/maxrave/simpmusic/Main.kt`](https://github.com/maxrave-dev/simpmusic/blob/dev/desktopApp/src/jvmMain/kotlin/com/maxrave/simpmusic/Main.kt) (Desktop host)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App entry"]
  node_android["Android host<br/>[MainActivity.kt]"]
  node_desktop["Desktop host<br/>[Main.kt]"]
  node_appui["Shared app UI<br/>[App.kt]"]
  node_navigation["Navigation"]
  node_viewmodels["View models<br/>[ViewModelModule.kt]"]
end

subgraph group_music["Music experience"]
  node_media["Playback service<br/>[MainActivity.kt]"]
  node_catalog["Music discovery"]
  node_search["Search"]
  node_player["Now playing"]
  node_lyrics["Lyrics<br/>[LyricsView.kt]"]
  node_audio["Audio effects"]
  node_library["Library"]
  node_offline["Offline playback"]
end

subgraph group_personal["Personal features"]
  node_analytics["Listening analytics"]
  node_wrapped["Wrapped recaps"]
  node_widgets["Home widgets"]
end

subgraph group_integrations["Integrations"]
  node_youtube["YouTube Music"]
  node_lyrics_services["Lyrics sources"]
  node_lastfm_client["Last.fm client<br/>[LastfmClient.kt]"]
  node_lastfm["Last.fm"]
  node_cast["Cast support<br/>[Cast.kt]"]
  node_cast_service["Cast service"]
  node_sponsor["SponsorBlock"]
  node_dislike["Return YouTube Dislike"]
end

node_user(("Listener"))

node_user -->|"launches"| node_android
node_user -->|"launches"| node_desktop
node_android -->|"hosts"| node_appui
node_desktop -->|"launches"| node_appui
node_appui -->|"navigates"| node_navigation
node_appui -->|"uses"| node_viewmodels
node_android -->|"starts service"| node_media
node_catalog -.->|"fetches catalog"| node_youtube
node_search -.->|"searches"| node_youtube
node_player -->|"controls playback"| node_media
node_media -.->|"streams audio"| node_youtube
node_player -->|"shows lyrics"| node_lyrics
node_lyrics -.->|"loads lyrics"| node_lyrics_services
node_player -->|"offers effects"| node_audio
node_library -->|"supports downloads"| node_offline
node_analytics -->|"recaps listening"| node_wrapped
node_widgets -->|"controls playback"| node_media
node_media -.->|"scrobbles plays"| node_lastfm_client
node_lastfm_client -.->|"posts requests"| node_lastfm
node_player -.->|"offers casting"| node_cast
node_cast -.->|"dispatches playback"| node_cast_service
node_media -.->|"checks segments"| node_sponsor
node_media -.->|"gets vote data"| node_dislike

click node_android "https://github.com/maxrave-dev/simpmusic/blob/dev/androidApp/src/main/java/com/maxrave/simpmusic/MainActivity.kt"
click node_desktop "https://github.com/maxrave-dev/simpmusic/blob/dev/desktopApp/src/jvmMain/kotlin/com/maxrave/simpmusic/Main.kt"
click node_appui "https://github.com/maxrave-dev/simpmusic/blob/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/App.kt"
click node_navigation "https://github.com/maxrave-dev/simpmusic/tree/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/graph"
click node_viewmodels "https://github.com/maxrave-dev/simpmusic/blob/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/di/ViewModelModule.kt"
click node_media "https://github.com/maxrave-dev/simpmusic/blob/dev/androidApp/src/main/java/com/maxrave/simpmusic/MainActivity.kt"
click node_catalog "https://github.com/maxrave-dev/simpmusic/tree/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination"
click node_search "https://github.com/maxrave-dev/simpmusic/blob/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/search/SearchDestination.kt"
click node_player "https://github.com/maxrave-dev/simpmusic/blob/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/player/FullscreenDestination.kt"
click node_lyrics "https://github.com/maxrave-dev/simpmusic/blob/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/component/LyricsView.kt"
click node_audio "https://github.com/maxrave-dev/simpmusic/blob/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/screen/home/EqualizerSection.kt"
click node_library "https://github.com/maxrave-dev/simpmusic/blob/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/library/LibraryDestination.kt"
click node_offline "https://github.com/maxrave-dev/simpmusic/tree/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/library"
click node_analytics "https://github.com/maxrave-dev/simpmusic/blob/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/home/AnalyticsDestination.kt"
click node_wrapped "https://github.com/maxrave-dev/simpmusic/blob/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/home/WrappedDestination.kt"
click node_widgets "https://github.com/maxrave-dev/simpmusic/tree/dev/androidApp/src/main/java/com/maxrave/simpmusic/ui/widget"
click node_lastfm_client "https://github.com/maxrave-dev/simpmusic/blob/dev/lastfm/src/commonMain/kotlin/org/simpmusic/lastfm/LastfmClient.kt"
click node_cast "https://github.com/maxrave-dev/simpmusic/blob/dev/cast/src/main/java/org/simpmusic/cast/Cast.kt"

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_android,node_desktop,node_appui,node_navigation,node_viewmodels toneBlue
class node_media,node_catalog,node_search,node_player,node_lyrics,node_audio,node_library,node_offline toneAmber
class node_analytics,node_wrapped,node_widgets toneMint
class node_youtube,node_lyrics_services,node_lastfm_client,node_lastfm,node_cast,node_cast_service,node_sponsor,node_dislike toneRose
class node_user toneIndigo
```

## Components

### App entry

- [Android host](https://github.com/maxrave-dev/simpmusic/blob/dev/androidApp/src/main/java/com/maxrave/simpmusic/MainActivity.kt): `androidApp/src/main/java/com/maxrave/simpmusic/MainActivity.kt`
- [Desktop host](https://github.com/maxrave-dev/simpmusic/blob/dev/desktopApp/src/jvmMain/kotlin/com/maxrave/simpmusic/Main.kt): `desktopApp/src/jvmMain/kotlin/com/maxrave/simpmusic/Main.kt`
- [Shared app UI](https://github.com/maxrave-dev/simpmusic/blob/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/App.kt): `composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/App.kt`
- [Navigation](https://github.com/maxrave-dev/simpmusic/tree/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/graph): `composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/graph`
- [View models](https://github.com/maxrave-dev/simpmusic/blob/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/di/ViewModelModule.kt): `composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/di/ViewModelModule.kt`

### Music experience

- [Playback service](https://github.com/maxrave-dev/simpmusic/blob/dev/androidApp/src/main/java/com/maxrave/simpmusic/MainActivity.kt): `androidApp/src/main/java/com/maxrave/simpmusic/MainActivity.kt`
- [Music discovery](https://github.com/maxrave-dev/simpmusic/tree/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination): `composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination`
- [Search](https://github.com/maxrave-dev/simpmusic/blob/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/search/SearchDestination.kt): `composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/search/SearchDestination.kt`
- [Now playing](https://github.com/maxrave-dev/simpmusic/blob/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/player/FullscreenDestination.kt): `composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/player/FullscreenDestination.kt`
- [Lyrics](https://github.com/maxrave-dev/simpmusic/blob/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/component/LyricsView.kt): `composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/component/LyricsView.kt`
- [Audio effects](https://github.com/maxrave-dev/simpmusic/blob/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/screen/home/EqualizerSection.kt): `composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/screen/home/EqualizerSection.kt`
- [Library](https://github.com/maxrave-dev/simpmusic/blob/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/library/LibraryDestination.kt): `composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/library/LibraryDestination.kt`
- [Offline playback](https://github.com/maxrave-dev/simpmusic/tree/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/library): `composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/library`

### Personal features

- [Listening analytics](https://github.com/maxrave-dev/simpmusic/blob/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/home/AnalyticsDestination.kt): `composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/home/AnalyticsDestination.kt`
- [Wrapped recaps](https://github.com/maxrave-dev/simpmusic/blob/dev/composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/home/WrappedDestination.kt): `composeApp/src/commonMain/kotlin/com/maxrave/simpmusic/ui/navigation/destination/home/WrappedDestination.kt`
- [Home widgets](https://github.com/maxrave-dev/simpmusic/tree/dev/androidApp/src/main/java/com/maxrave/simpmusic/ui/widget): `androidApp/src/main/java/com/maxrave/simpmusic/ui/widget`

### Integrations

- **YouTube Music**
- **Lyrics sources**
- [Last.fm client](https://github.com/maxrave-dev/simpmusic/blob/dev/lastfm/src/commonMain/kotlin/org/simpmusic/lastfm/LastfmClient.kt): `lastfm/src/commonMain/kotlin/org/simpmusic/lastfm/LastfmClient.kt`
- **Last.fm**
- [Cast support](https://github.com/maxrave-dev/simpmusic/blob/dev/cast/src/main/java/org/simpmusic/cast/Cast.kt): `cast/src/main/java/org/simpmusic/cast/Cast.kt`
- **Cast service**
- **SponsorBlock**
- **Return YouTube Dislike**

### Other components

- **Listener**

## Connections

- 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
