How darshan8610/decibel works
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: App.kt App shell · SimpleMediaService.kt Media service · MediaPlayerHandler.kt Player handler · MainActivity.kt Android activity
Components 23
App and navigation
- App shell
composeApp/src/commonMain/kotlin/com/decibel/music/App.kt - Navigation graph
composeApp/src/commonMain/kotlin/com/decibel/music/ui/navigation/graph/AppNavigationGraph.kt - Android activity
androidApp/src/main/java/com/decibel/music/MainActivity.kt
Discovery and library
- Search screen
composeApp/src/commonMain/kotlin/com/decibel/music/ui/screen/other/SearchScreen.kt - Library screens
composeApp/src/commonMain/kotlin/com/decibel/music/ui/screen/library/LibraryScreen.kt - Catalog screens
composeApp/src/commonMain/kotlin/com/decibel/music/ui/screen/other/PlaylistScreen.kt - Search repository
core/data/src/commonMain/kotlin/com/decibel/music/data/repository/SearchRepositoryImpl.kt - Search contract
core/domain/src/commonMain/kotlin/com/decibel/music/domain/repository/SearchRepository.kt - YouTube Music client
core/service/kotlinYtmusicScraper/src/commonMain/kotlin/com/decibel/music/ytmusic/YouTube.kt
Playback and media
- Now playing
composeApp/src/commonMain/kotlin/com/decibel/music/ui/screen/player/NowPlayingScreen.kt - Player handler
core/domain/src/commonMain/kotlin/com/decibel/music/domain/mediaservice/handler/MediaPlayerHandler.kt - Media service
core/media/media3/src/main/java/com/decibel/music/media3/service/SimpleMediaService.kt - Download service
core/media/media3/src/main/java/com/decibel/music/media3/service/download/MusicDownloadService.kt - Cast handoff
core/media/media3/src/main/java/com/decibel/music/media3/cast/CastHandoffManager.kt - Car app service
core/media/media3/src/main/java/com/decibel/music/media3/carapp/DecibelCarAppService.kt
Integrations and state
- Preferences store
core/data/src/commonMain/kotlin/com/decibel/music/data/dataStore/DataStoreManagerImpl.kt - Settings contract
core/domain/src/commonMain/kotlin/com/decibel/music/domain/manager/DataStoreManager.kt - Lyrics client
core/service/lyricsService/src/commonMain/kotlin/com/decibel/music/lyrics/DecibelLyricsClient.kt - AI service
core/service/aiService/src/commonMain/kotlin/com/decibel/music/aiservice/AiService.kt - Last.fm integration
lastfm-empty/src/commonMain/kotlin/com/decibel/music/lastfm/Lastfm.kt - Spotify integration
core/service/spotify/src/commonMain/kotlin/com/decibel/music/spotify/SpotifyTrackQuery.kt
Other components
- Listener
- Android host
Connections 16
- Listener → App shell: uses
composeApp/src/commonMain/kotlin/com/decibel/music/App.kt - App shell → Navigation graph: routes through
composeApp/src/commonMain/kotlin/com/decibel/music/App.kt - Android host → Android activity: launches
androidApp/src/main/java/com/decibel/music/MainActivity.kt - Android activity → App shell: starts UI
androidApp/src/main/java/com/decibel/music/MainActivity.kt - Android activity → Media service: starts service
androidApp/src/main/java/com/decibel/music/MainActivity.kt - App shell → Now playing: shows
composeApp/src/commonMain/kotlin/com/decibel/music/App.kt - Search screen → Search repository: requests results
- Search repository → YouTube Music client: queries
core/data/src/commonMain/kotlin/com/decibel/music/data/repository/SearchRepositoryImpl.kt - Search repository → Search contract: implements
core/data/src/commonMain/kotlin/com/decibel/music/data/repository/SearchRepositoryImpl.kt - Now playing → Player handler: controls playback
- Media service → Player handler: uses handler
core/media/media3/src/main/java/com/decibel/music/media3/service/SimpleMediaService.kt - Media service → Settings contract: reads settings
core/media/media3/src/main/java/com/decibel/music/media3/service/SimpleMediaService.kt - Preferences store → Settings contract: implements
core/data/src/commonMain/kotlin/com/decibel/music/data/dataStore/DataStoreManagerImpl.kt - Download service → Player handler: uses handler
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
core/media/media3/src/main/java/com/decibel/music/media3/carapp/DecibelCarAppService.kt