How blooming-design/bloommusic works
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: PlaybackService.kt Playback service · Repository.kt Library repository · SearchRepository.kt Search repository · EqualizerManager.kt Sound settings
Components 24
App experience
- Main navigation
app/src/main/java/com/mardous/booming/ui/screen/MainActivity.kt - Library browsing
app/src/main/java/com/mardous/booming/ui/screen/library - Library search
app/src/main/java/com/mardous/booming/ui/screen/library/search/SearchFragment.kt - Tag editor
app/src/main/java/com/mardous/booming/ui/screen/tageditor/SongTagEditorActivity.kt - Equalizer controls
app/src/main/java/com/mardous/booming/ui/screen/equalizer/EqualizerFragment.kt
Music library
- Library repository
app/src/main/java/com/mardous/booming/data/local/repository/Repository.kt - Search repository
app/src/main/java/com/mardous/booming/data/local/repository/SearchRepository.kt - Smart collections
app/src/main/java/com/mardous/booming/data/local/repository/SpecialRepository.kt - MediaStore access
app/src/main/java/com/mardous/booming/data/local/MediaQueryDispatcher.kt - Song model
app/src/main/java/com/mardous/booming/data/model/Song.kt
Playback and sound
- Playback service
app/src/main/java/com/mardous/booming/playback/PlaybackService.kt - Media controller
app/src/main/java/com/mardous/booming/MediaControllerOwner.kt - Playback restoration
app/src/main/java/com/mardous/booming/playback/PersistentStorage.kt - Sound settings
app/src/main/java/com/mardous/booming/playback/equalizer/EqualizerManager.kt - Audio effect engines
app/src/main/java/com/mardous/booming/playback/equalizer/engine/EQEngine.kt
Lyrics and artwork
- Synced lyrics view
app/src/main/java/com/mardous/booming/ui/component/compose/lyrics/LyricsView.kt - Lyrics download
app/src/main/java/com/mardous/booming/data/remote/lyrics/LyricsDownloadService.kt - Lyrics parsing
app/src/main/java/com/mardous/booming/data/local/lyrics - Artwork loading
app/src/main/java/com/mardous/booming/coil/CustomArtistImageManager.kt
Persistence and device
- Room database
app/src/main/java/com/mardous/booming/core/BoomingDatabase.kt - App preferences
app/src/main/java/com/mardous/booming/util/Preferences.kt - Playback widgets
app/src/main/java/com/mardous/booming/core/appwidgets/BoomingGlanceWidget.kt
Other components
- Listener
- Deezer API
Connections 25
- Listener → Main navigation: opens app
- Main navigation → Library browsing: navigates
- Listener → Library search: searches library
README.md - Library search → Search repository: queries
app/src/main/java/com/mardous/booming/data/local/repository/SearchRepository.kt - Search repository → Smart collections: uses collections
app/src/main/java/com/mardous/booming/data/local/repository/SearchRepository.kt - Search repository → Song model: returns songs
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
README.md - Listener → Playback service: starts playback
README.md - Media controller → Playback service: controls session
app/src/main/java/com/mardous/booming/MediaControllerOwner.kt - Playback service → Library repository: loads songs
app/src/main/java/com/mardous/booming/playback/PlaybackService.kt - Playback service → Playback restoration: restores queue
app/src/main/java/com/mardous/booming/playback/PersistentStorage.kt - Playback service → Playback widgets: updates controls
app/src/main/java/com/mardous/booming/playback/PlaybackService.kt - Playback service → Sound settings: prepares effects
app/src/main/java/com/mardous/booming/playback/PlaybackService.kt - Equalizer controls → Sound settings: configures sound
- Sound settings → Audio effect engines: creates engine
app/src/main/java/com/mardous/booming/playback/equalizer/EqualizerManager.kt - Listener → Lyrics download: fetches lyrics
README.md - Lyrics download → Lyrics parsing: parses lyrics
- Synced lyrics view → Lyrics parsing: renders lyrics
README.md - Listener → Tag editor: edits metadata
README.md - Listener → Artwork loading: views artwork
README.md - Artwork loading → Deezer API: looks up artists
- Playback service → App preferences: reads settings
app/src/main/java/com/mardous/booming/playback/PlaybackService.kt - Library repository → Smart collections: delegates collections
app/src/main/java/com/mardous/booming/data/local/repository/Repository.kt