# darshan8610/decibel architecture

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

- Interactive diagram: https://gitdiagram.com/darshan8610/decibel
- Repository: https://github.com/darshan8610/decibel

## Overview

Decibel is a cross-platform music player with catalog discovery, library and playlist browsing, and persistent playback. On Android, the app entry point receives user actions and launches the media service; shared UI provides navigation and playback screens. Search implementation fetches and parses YouTube Music results, while platform media services manage playback and downloads. The tree and excerpts support these main boundaries, but do not expose the full library, lyrics, or settings wiring, so those relationships are not asserted here.

Main entry points: [`composeApp/src/commonMain/kotlin/com/decibel/music/App.kt`](https://github.com/darshan8610/decibel/blob/main/composeApp/src/commonMain/kotlin/com/decibel/music/App.kt) (App shell), [`core/media/media3/src/main/java/com/decibel/music/media3/service/SimpleMediaService.kt`](https://github.com/darshan8610/decibel/blob/main/core/media/media3/src/main/java/com/decibel/music/media3/service/SimpleMediaService.kt) (Media service), [`core/domain/src/commonMain/kotlin/com/decibel/music/domain/mediaservice/handler/MediaPlayerHandler.kt`](https://github.com/darshan8610/decibel/blob/main/core/domain/src/commonMain/kotlin/com/decibel/music/domain/mediaservice/handler/MediaPlayerHandler.kt) (Player handler), [`androidApp/src/main/java/com/decibel/music/MainActivity.kt`](https://github.com/darshan8610/decibel/blob/main/androidApp/src/main/java/com/decibel/music/MainActivity.kt) (Android activity)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and navigation"]
  node_appui["App shell<br/>[App.kt]"]
  node_navigation["Navigation graph"]
  node_androidhost["Android activity<br/>[MainActivity.kt]"]
end

subgraph group_catalog["Discovery and library"]
  node_searchui["Search screen<br/>[SearchScreen.kt]"]
  node_libraryui["Library screens<br/>[LibraryScreen.kt]"]
  node_playlistui["Catalog screens<br/>[PlaylistScreen.kt]"]
  node_searchrepo["Search repository"]
  node_searchcontract["Search contract"]
  node_ytmusic["YouTube Music client<br/>[YouTube.kt]"]
end

subgraph group_playback["Playback and media"]
  node_playerui["Now playing"]
  node_playercontract["Player handler"]
  node_mediaservice["Media service"]
  node_download["Download service"]
  node_cast["Cast handoff"]
  node_car["Car app service"]
end

subgraph group_services["Integrations and state"]
  node_datastore[("Preferences store")]
  node_datacontract["Settings contract"]
  node_lyrics["Lyrics client"]
  node_ai["AI service<br/>[AiService.kt]"]
  node_lastfm["Last.fm integration<br/>[Lastfm.kt]"]
  node_spotify["Spotify integration"]
end

node_user(("Listener"))
node_android["Android host"]

node_user -->|"uses"| node_appui
node_appui -->|"routes through"| node_navigation
node_android -->|"launches"| node_androidhost
node_androidhost -->|"starts UI"| node_appui
node_androidhost -->|"starts service"| node_mediaservice
node_appui -->|"shows"| node_playerui
node_searchui -.->|"requests results"| node_searchrepo
node_searchrepo -->|"queries"| node_ytmusic
node_searchrepo -->|"implements"| node_searchcontract
node_playerui -.->|"controls playback"| node_playercontract
node_mediaservice -->|"uses handler"| node_playercontract
node_mediaservice -->|"reads settings"| node_datacontract
node_datastore -->|"implements"| node_datacontract
node_download -->|"uses handler"| node_playercontract
node_cast -.->|"transfers playback"| node_playercontract
node_car -->|"uses session"| node_mediaservice

click node_appui "https://github.com/darshan8610/decibel/blob/main/composeApp/src/commonMain/kotlin/com/decibel/music/App.kt"
click node_navigation "https://github.com/darshan8610/decibel/blob/main/composeApp/src/commonMain/kotlin/com/decibel/music/ui/navigation/graph/AppNavigationGraph.kt"
click node_searchui "https://github.com/darshan8610/decibel/blob/main/composeApp/src/commonMain/kotlin/com/decibel/music/ui/screen/other/SearchScreen.kt"
click node_libraryui "https://github.com/darshan8610/decibel/blob/main/composeApp/src/commonMain/kotlin/com/decibel/music/ui/screen/library/LibraryScreen.kt"
click node_playlistui "https://github.com/darshan8610/decibel/blob/main/composeApp/src/commonMain/kotlin/com/decibel/music/ui/screen/other/PlaylistScreen.kt"
click node_searchrepo "https://github.com/darshan8610/decibel/blob/main/core/data/src/commonMain/kotlin/com/decibel/music/data/repository/SearchRepositoryImpl.kt"
click node_searchcontract "https://github.com/darshan8610/decibel/blob/main/core/domain/src/commonMain/kotlin/com/decibel/music/domain/repository/SearchRepository.kt"
click node_ytmusic "https://github.com/darshan8610/decibel/blob/main/core/service/kotlinYtmusicScraper/src/commonMain/kotlin/com/decibel/music/ytmusic/YouTube.kt"
click node_playerui "https://github.com/darshan8610/decibel/blob/main/composeApp/src/commonMain/kotlin/com/decibel/music/ui/screen/player/NowPlayingScreen.kt"
click node_playercontract "https://github.com/darshan8610/decibel/blob/main/core/domain/src/commonMain/kotlin/com/decibel/music/domain/mediaservice/handler/MediaPlayerHandler.kt"
click node_androidhost "https://github.com/darshan8610/decibel/blob/main/androidApp/src/main/java/com/decibel/music/MainActivity.kt"
click node_mediaservice "https://github.com/darshan8610/decibel/blob/main/core/media/media3/src/main/java/com/decibel/music/media3/service/SimpleMediaService.kt"
click node_download "https://github.com/darshan8610/decibel/blob/main/core/media/media3/src/main/java/com/decibel/music/media3/service/download/MusicDownloadService.kt"
click node_cast "https://github.com/darshan8610/decibel/blob/main/core/media/media3/src/main/java/com/decibel/music/media3/cast/CastHandoffManager.kt"
click node_car "https://github.com/darshan8610/decibel/blob/main/core/media/media3/src/main/java/com/decibel/music/media3/carapp/DecibelCarAppService.kt"
click node_datastore "https://github.com/darshan8610/decibel/blob/main/core/data/src/commonMain/kotlin/com/decibel/music/data/dataStore/DataStoreManagerImpl.kt"
click node_datacontract "https://github.com/darshan8610/decibel/blob/main/core/domain/src/commonMain/kotlin/com/decibel/music/domain/manager/DataStoreManager.kt"
click node_lyrics "https://github.com/darshan8610/decibel/blob/main/core/service/lyricsService/src/commonMain/kotlin/com/decibel/music/lyrics/DecibelLyricsClient.kt"
click node_ai "https://github.com/darshan8610/decibel/blob/main/core/service/aiService/src/commonMain/kotlin/com/decibel/music/aiservice/AiService.kt"
click node_lastfm "https://github.com/darshan8610/decibel/blob/main/lastfm-empty/src/commonMain/kotlin/com/decibel/music/lastfm/Lastfm.kt"
click node_spotify "https://github.com/darshan8610/decibel/blob/main/core/service/spotify/src/commonMain/kotlin/com/decibel/music/spotify/SpotifyTrackQuery.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_appui,node_navigation,node_androidhost toneBlue
class node_searchui,node_libraryui,node_playlistui,node_searchrepo,node_searchcontract,node_ytmusic toneAmber
class node_playerui,node_playercontract,node_mediaservice,node_download,node_cast,node_car toneMint
class node_datastore,node_datacontract,node_lyrics,node_ai,node_lastfm,node_spotify toneRose
class node_user,node_android toneIndigo
```

## Components

### App and navigation

- [App shell](https://github.com/darshan8610/decibel/blob/main/composeApp/src/commonMain/kotlin/com/decibel/music/App.kt): `composeApp/src/commonMain/kotlin/com/decibel/music/App.kt`
- [Navigation graph](https://github.com/darshan8610/decibel/blob/main/composeApp/src/commonMain/kotlin/com/decibel/music/ui/navigation/graph/AppNavigationGraph.kt): `composeApp/src/commonMain/kotlin/com/decibel/music/ui/navigation/graph/AppNavigationGraph.kt`
- [Android activity](https://github.com/darshan8610/decibel/blob/main/androidApp/src/main/java/com/decibel/music/MainActivity.kt): `androidApp/src/main/java/com/decibel/music/MainActivity.kt`

### Discovery and library

- [Search screen](https://github.com/darshan8610/decibel/blob/main/composeApp/src/commonMain/kotlin/com/decibel/music/ui/screen/other/SearchScreen.kt): `composeApp/src/commonMain/kotlin/com/decibel/music/ui/screen/other/SearchScreen.kt`
- [Library screens](https://github.com/darshan8610/decibel/blob/main/composeApp/src/commonMain/kotlin/com/decibel/music/ui/screen/library/LibraryScreen.kt): `composeApp/src/commonMain/kotlin/com/decibel/music/ui/screen/library/LibraryScreen.kt`
- [Catalog screens](https://github.com/darshan8610/decibel/blob/main/composeApp/src/commonMain/kotlin/com/decibel/music/ui/screen/other/PlaylistScreen.kt): `composeApp/src/commonMain/kotlin/com/decibel/music/ui/screen/other/PlaylistScreen.kt`
- [Search repository](https://github.com/darshan8610/decibel/blob/main/core/data/src/commonMain/kotlin/com/decibel/music/data/repository/SearchRepositoryImpl.kt): `core/data/src/commonMain/kotlin/com/decibel/music/data/repository/SearchRepositoryImpl.kt`
- [Search contract](https://github.com/darshan8610/decibel/blob/main/core/domain/src/commonMain/kotlin/com/decibel/music/domain/repository/SearchRepository.kt): `core/domain/src/commonMain/kotlin/com/decibel/music/domain/repository/SearchRepository.kt`
- [YouTube Music client](https://github.com/darshan8610/decibel/blob/main/core/service/kotlinYtmusicScraper/src/commonMain/kotlin/com/decibel/music/ytmusic/YouTube.kt): `core/service/kotlinYtmusicScraper/src/commonMain/kotlin/com/decibel/music/ytmusic/YouTube.kt`

### Playback and media

- [Now playing](https://github.com/darshan8610/decibel/blob/main/composeApp/src/commonMain/kotlin/com/decibel/music/ui/screen/player/NowPlayingScreen.kt): `composeApp/src/commonMain/kotlin/com/decibel/music/ui/screen/player/NowPlayingScreen.kt`
- [Player handler](https://github.com/darshan8610/decibel/blob/main/core/domain/src/commonMain/kotlin/com/decibel/music/domain/mediaservice/handler/MediaPlayerHandler.kt): `core/domain/src/commonMain/kotlin/com/decibel/music/domain/mediaservice/handler/MediaPlayerHandler.kt`
- [Media service](https://github.com/darshan8610/decibel/blob/main/core/media/media3/src/main/java/com/decibel/music/media3/service/SimpleMediaService.kt): `core/media/media3/src/main/java/com/decibel/music/media3/service/SimpleMediaService.kt`
- [Download service](https://github.com/darshan8610/decibel/blob/main/core/media/media3/src/main/java/com/decibel/music/media3/service/download/MusicDownloadService.kt): `core/media/media3/src/main/java/com/decibel/music/media3/service/download/MusicDownloadService.kt`
- [Cast handoff](https://github.com/darshan8610/decibel/blob/main/core/media/media3/src/main/java/com/decibel/music/media3/cast/CastHandoffManager.kt): `core/media/media3/src/main/java/com/decibel/music/media3/cast/CastHandoffManager.kt`
- [Car app service](https://github.com/darshan8610/decibel/blob/main/core/media/media3/src/main/java/com/decibel/music/media3/carapp/DecibelCarAppService.kt): `core/media/media3/src/main/java/com/decibel/music/media3/carapp/DecibelCarAppService.kt`

### Integrations and state

- [Preferences store](https://github.com/darshan8610/decibel/blob/main/core/data/src/commonMain/kotlin/com/decibel/music/data/dataStore/DataStoreManagerImpl.kt): `core/data/src/commonMain/kotlin/com/decibel/music/data/dataStore/DataStoreManagerImpl.kt`
- [Settings contract](https://github.com/darshan8610/decibel/blob/main/core/domain/src/commonMain/kotlin/com/decibel/music/domain/manager/DataStoreManager.kt): `core/domain/src/commonMain/kotlin/com/decibel/music/domain/manager/DataStoreManager.kt`
- [Lyrics client](https://github.com/darshan8610/decibel/blob/main/core/service/lyricsService/src/commonMain/kotlin/com/decibel/music/lyrics/DecibelLyricsClient.kt): `core/service/lyricsService/src/commonMain/kotlin/com/decibel/music/lyrics/DecibelLyricsClient.kt`
- [AI service](https://github.com/darshan8610/decibel/blob/main/core/service/aiService/src/commonMain/kotlin/com/decibel/music/aiservice/AiService.kt): `core/service/aiService/src/commonMain/kotlin/com/decibel/music/aiservice/AiService.kt`
- [Last.fm integration](https://github.com/darshan8610/decibel/blob/main/lastfm-empty/src/commonMain/kotlin/com/decibel/music/lastfm/Lastfm.kt): `lastfm-empty/src/commonMain/kotlin/com/decibel/music/lastfm/Lastfm.kt`
- [Spotify integration](https://github.com/darshan8610/decibel/blob/main/core/service/spotify/src/commonMain/kotlin/com/decibel/music/spotify/SpotifyTrackQuery.kt): `core/service/spotify/src/commonMain/kotlin/com/decibel/music/spotify/SpotifyTrackQuery.kt`

### Other components

- **Listener**
- **Android host**

## Connections

- Listener → App shell: uses (evidence: `composeApp/src/commonMain/kotlin/com/decibel/music/App.kt`)
- App shell → Navigation graph: routes through (evidence: `composeApp/src/commonMain/kotlin/com/decibel/music/App.kt`)
- Android host → Android activity: launches (evidence: `androidApp/src/main/java/com/decibel/music/MainActivity.kt`)
- Android activity → App shell: starts UI (evidence: `androidApp/src/main/java/com/decibel/music/MainActivity.kt`)
- Android activity → Media service: starts service (evidence: `androidApp/src/main/java/com/decibel/music/MainActivity.kt`)
- App shell → Now playing: shows (evidence: `composeApp/src/commonMain/kotlin/com/decibel/music/App.kt`)
- Search screen → Search repository: requests results
- Search repository → YouTube Music client: queries (evidence: `core/data/src/commonMain/kotlin/com/decibel/music/data/repository/SearchRepositoryImpl.kt`)
- Search repository → Search contract: implements (evidence: `core/data/src/commonMain/kotlin/com/decibel/music/data/repository/SearchRepositoryImpl.kt`)
- Now playing → Player handler: controls playback
- Media service → Player handler: uses handler (evidence: `core/media/media3/src/main/java/com/decibel/music/media3/service/SimpleMediaService.kt`)
- Media service → Settings contract: reads settings (evidence: `core/media/media3/src/main/java/com/decibel/music/media3/service/SimpleMediaService.kt`)
- Preferences store → Settings contract: implements (evidence: `core/data/src/commonMain/kotlin/com/decibel/music/data/dataStore/DataStoreManagerImpl.kt`)
- Download service → Player handler: uses handler (evidence: `core/media/media3/src/main/java/com/decibel/music/media3/service/download/MusicDownloadService.kt`)
- Cast handoff → Player handler: transfers playback
- Car app service → Media service: uses session (evidence: `core/media/media3/src/main/java/com/decibel/music/media3/carapp/DecibelCarAppService.kt`)
