# blooming-design/bloommusic architecture

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

- Interactive diagram: https://gitdiagram.com/blooming-design/bloommusic
- Repository: https://github.com/blooming-design/bloommusic

## Overview

Booming Music is an Android local-music player. The main user journey is browsing or searching a device library, selecting music for playback, and controlling the player; the repository also documents lyrics, equalization, playlists, widgets, artwork, and metadata editing. The graph emphasizes these product stages and their supporting data and audio layers. Several subsystem links are documented capabilities rather than inspected call sites because source excerpts are partial; those edges are dashed where wiring is not verified.

Main entry points: [`app/src/main/java/com/mardous/booming/playback/PlaybackService.kt`](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/playback/PlaybackService.kt) (Playback service), [`app/src/main/java/com/mardous/booming/data/local/repository/Repository.kt`](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/data/local/repository/Repository.kt) (Library repository), [`app/src/main/java/com/mardous/booming/data/local/repository/SearchRepository.kt`](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/data/local/repository/SearchRepository.kt) (Search repository), [`app/src/main/java/com/mardous/booming/playback/equalizer/EqualizerManager.kt`](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/playback/equalizer/EqualizerManager.kt) (Sound settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_main["Main navigation<br/>[MainActivity.kt]"]
  node_libraryui["Library browsing"]
  node_searchui["Library search<br/>[SearchFragment.kt]"]
  node_tagui["Tag editor"]
  node_equi["Equalizer controls"]
end

subgraph group_library["Music library"]
  node_repository["Library repository<br/>[Repository.kt]"]
  node_searchrepo["Search repository"]
  node_specialrepo["Smart collections"]
  node_mediaquery["MediaStore access"]
  node_song["Song model<br/>[Song.kt]"]
end

subgraph group_playback["Playback and sound"]
  node_service["Playback service<br/>[PlaybackService.kt]"]
  node_controller["Media controller"]
  node_queue["Playback restoration"]
  node_eqmanager["Sound settings"]
  node_eqengine["Audio effect engines<br/>[EQEngine.kt]"]
end

subgraph group_media["Lyrics and artwork"]
  node_lyricsui["Synced lyrics view<br/>[LyricsView.kt]"]
  node_lyricsdownload["Lyrics download"]
  node_lyricsparse["Lyrics parsing"]
  node_artwork["Artwork loading"]
end

subgraph group_platform["Persistence and device"]
  node_database[("Room database<br/>[BoomingDatabase.kt]")]
  node_preferences[("App preferences<br/>[Preferences.kt]")]
  node_widget["Playback widgets"]
end

node_listener(("Listener"))
node_deezer{{"Deezer API"}}

node_listener -.->|"opens app"| node_main
node_main -.->|"navigates"| node_libraryui
node_listener -.->|"searches library"| node_searchui
node_searchui -.->|"queries"| node_searchrepo
node_searchrepo -->|"uses collections"| node_specialrepo
node_searchrepo -->|"returns songs"| node_song
node_libraryui -.->|"requests library"| node_repository
node_repository -.->|"queries media"| node_mediaquery
node_repository -.->|"persists data"| node_database
node_listener -.->|"starts playback"| node_service
node_controller -->|"controls session"| node_service
node_service -->|"loads songs"| node_repository
node_service -.->|"restores queue"| node_queue
node_service -->|"updates controls"| node_widget
node_service -->|"prepares effects"| node_eqmanager
node_equi -.->|"configures sound"| node_eqmanager
node_eqmanager -->|"creates engine"| node_eqengine
node_listener -.->|"fetches lyrics"| node_lyricsdownload
node_lyricsdownload -.->|"parses lyrics"| node_lyricsparse
node_lyricsui -.->|"renders lyrics"| node_lyricsparse
node_listener -.->|"edits metadata"| node_tagui
node_listener -.->|"views artwork"| node_artwork
node_artwork -.->|"looks up artists"| node_deezer
node_service -->|"reads settings"| node_preferences
node_repository -->|"delegates collections"| node_specialrepo

click node_main "https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/ui/screen/MainActivity.kt"
click node_libraryui "https://github.com/blooming-design/bloommusic/tree/master/app/src/main/java/com/mardous/booming/ui/screen/library"
click node_searchui "https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/ui/screen/library/search/SearchFragment.kt"
click node_tagui "https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/ui/screen/tageditor/SongTagEditorActivity.kt"
click node_repository "https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/data/local/repository/Repository.kt"
click node_searchrepo "https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/data/local/repository/SearchRepository.kt"
click node_specialrepo "https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/data/local/repository/SpecialRepository.kt"
click node_mediaquery "https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/data/local/MediaQueryDispatcher.kt"
click node_song "https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/data/model/Song.kt"
click node_service "https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/playback/PlaybackService.kt"
click node_controller "https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/MediaControllerOwner.kt"
click node_queue "https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/playback/PersistentStorage.kt"
click node_equi "https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/ui/screen/equalizer/EqualizerFragment.kt"
click node_eqmanager "https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/playback/equalizer/EqualizerManager.kt"
click node_eqengine "https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/playback/equalizer/engine/EQEngine.kt"
click node_lyricsui "https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/ui/component/compose/lyrics/LyricsView.kt"
click node_lyricsdownload "https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/data/remote/lyrics/LyricsDownloadService.kt"
click node_lyricsparse "https://github.com/blooming-design/bloommusic/tree/master/app/src/main/java/com/mardous/booming/data/local/lyrics"
click node_artwork "https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/coil/CustomArtistImageManager.kt"
click node_database "https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/core/BoomingDatabase.kt"
click node_preferences "https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/util/Preferences.kt"
click node_widget "https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/core/appwidgets/BoomingGlanceWidget.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_main,node_libraryui,node_searchui,node_tagui,node_equi toneBlue
class node_repository,node_searchrepo,node_specialrepo,node_mediaquery,node_song toneAmber
class node_service,node_controller,node_queue,node_eqmanager,node_eqengine,node_deezer toneMint
class node_lyricsui,node_lyricsdownload,node_lyricsparse,node_artwork toneRose
class node_database,node_preferences,node_widget,node_listener toneIndigo
```

## Components

### App experience

- [Main navigation](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/ui/screen/MainActivity.kt): `app/src/main/java/com/mardous/booming/ui/screen/MainActivity.kt`
- [Library browsing](https://github.com/blooming-design/bloommusic/tree/master/app/src/main/java/com/mardous/booming/ui/screen/library): `app/src/main/java/com/mardous/booming/ui/screen/library`
- [Library search](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/ui/screen/library/search/SearchFragment.kt): `app/src/main/java/com/mardous/booming/ui/screen/library/search/SearchFragment.kt`
- [Tag editor](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/ui/screen/tageditor/SongTagEditorActivity.kt): `app/src/main/java/com/mardous/booming/ui/screen/tageditor/SongTagEditorActivity.kt`
- [Equalizer controls](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/ui/screen/equalizer/EqualizerFragment.kt): `app/src/main/java/com/mardous/booming/ui/screen/equalizer/EqualizerFragment.kt`

### Music library

- [Library repository](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/data/local/repository/Repository.kt): `app/src/main/java/com/mardous/booming/data/local/repository/Repository.kt`
- [Search repository](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/data/local/repository/SearchRepository.kt): `app/src/main/java/com/mardous/booming/data/local/repository/SearchRepository.kt`
- [Smart collections](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/data/local/repository/SpecialRepository.kt): `app/src/main/java/com/mardous/booming/data/local/repository/SpecialRepository.kt`
- [MediaStore access](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/data/local/MediaQueryDispatcher.kt): `app/src/main/java/com/mardous/booming/data/local/MediaQueryDispatcher.kt`
- [Song model](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/data/model/Song.kt): `app/src/main/java/com/mardous/booming/data/model/Song.kt`

### Playback and sound

- [Playback service](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/playback/PlaybackService.kt): `app/src/main/java/com/mardous/booming/playback/PlaybackService.kt`
- [Media controller](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/MediaControllerOwner.kt): `app/src/main/java/com/mardous/booming/MediaControllerOwner.kt`
- [Playback restoration](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/playback/PersistentStorage.kt): `app/src/main/java/com/mardous/booming/playback/PersistentStorage.kt`
- [Sound settings](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/playback/equalizer/EqualizerManager.kt): `app/src/main/java/com/mardous/booming/playback/equalizer/EqualizerManager.kt`
- [Audio effect engines](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/playback/equalizer/engine/EQEngine.kt): `app/src/main/java/com/mardous/booming/playback/equalizer/engine/EQEngine.kt`

### Lyrics and artwork

- [Synced lyrics view](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/ui/component/compose/lyrics/LyricsView.kt): `app/src/main/java/com/mardous/booming/ui/component/compose/lyrics/LyricsView.kt`
- [Lyrics download](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/data/remote/lyrics/LyricsDownloadService.kt): `app/src/main/java/com/mardous/booming/data/remote/lyrics/LyricsDownloadService.kt`
- [Lyrics parsing](https://github.com/blooming-design/bloommusic/tree/master/app/src/main/java/com/mardous/booming/data/local/lyrics): `app/src/main/java/com/mardous/booming/data/local/lyrics`
- [Artwork loading](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/coil/CustomArtistImageManager.kt): `app/src/main/java/com/mardous/booming/coil/CustomArtistImageManager.kt`

### Persistence and device

- [Room database](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/core/BoomingDatabase.kt): `app/src/main/java/com/mardous/booming/core/BoomingDatabase.kt`
- [App preferences](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/util/Preferences.kt): `app/src/main/java/com/mardous/booming/util/Preferences.kt`
- [Playback widgets](https://github.com/blooming-design/bloommusic/blob/master/app/src/main/java/com/mardous/booming/core/appwidgets/BoomingGlanceWidget.kt): `app/src/main/java/com/mardous/booming/core/appwidgets/BoomingGlanceWidget.kt`

### Other components

- **Listener**
- **Deezer API**

## Connections

- Listener → Main navigation: opens app
- Main navigation → Library browsing: navigates
- Listener → Library search: searches library (evidence: `README.md`)
- Library search → Search repository: queries (evidence: `app/src/main/java/com/mardous/booming/data/local/repository/SearchRepository.kt`)
- Search repository → Smart collections: uses collections (evidence: `app/src/main/java/com/mardous/booming/data/local/repository/SearchRepository.kt`)
- Search repository → Song model: returns songs (evidence: `app/src/main/java/com/mardous/booming/data/local/repository/SearchRepository.kt`)
- Library browsing → Library repository: requests library
- Library repository → MediaStore access: queries media
- Library repository → Room database: persists data (evidence: `README.md`)
- Listener → Playback service: starts playback (evidence: `README.md`)
- Media controller → Playback service: controls session (evidence: `app/src/main/java/com/mardous/booming/MediaControllerOwner.kt`)
- Playback service → Library repository: loads songs (evidence: `app/src/main/java/com/mardous/booming/playback/PlaybackService.kt`)
- Playback service → Playback restoration: restores queue (evidence: `app/src/main/java/com/mardous/booming/playback/PersistentStorage.kt`)
- Playback service → Playback widgets: updates controls (evidence: `app/src/main/java/com/mardous/booming/playback/PlaybackService.kt`)
- Playback service → Sound settings: prepares effects (evidence: `app/src/main/java/com/mardous/booming/playback/PlaybackService.kt`)
- Equalizer controls → Sound settings: configures sound
- Sound settings → Audio effect engines: creates engine (evidence: `app/src/main/java/com/mardous/booming/playback/equalizer/EqualizerManager.kt`)
- Listener → Lyrics download: fetches lyrics (evidence: `README.md`)
- Lyrics download → Lyrics parsing: parses lyrics
- Synced lyrics view → Lyrics parsing: renders lyrics (evidence: `README.md`)
- Listener → Tag editor: edits metadata (evidence: `README.md`)
- Listener → Artwork loading: views artwork (evidence: `README.md`)
- Artwork loading → Deezer API: looks up artists
- Playback service → App preferences: reads settings (evidence: `app/src/main/java/com/mardous/booming/playback/PlaybackService.kt`)
- Library repository → Smart collections: delegates collections (evidence: `app/src/main/java/com/mardous/booming/data/local/repository/Repository.kt`)
