Important
Booming SS is an unofficial source-separation build based on Booming Music. It is not affiliated with or endorsed by the upstream maintainers unless explicitly stated. The fork keeps the original local music player experience and adds experimental local stem separation features.
- ποΈ Source Separation Fork
- β¨ Key Features
- πΈ Screenshots
- π₯ Download & Install
- π» Tech Stack
- π§© Roadmap
- π Useful Links
- π€ Contributing
- π Support Development
- π Credits
- βοΈ License
Booming SS uses the package name com.wluhwluh.booming.sourcesep, so it can be
installed alongside the original Booming Music app.
What this fork adds:
- Separated playback for local tracks, with vocals/instrumental blend controls.
- Per-song blend memory, quick lyrics-overlay controls, and a dedicated source separation panel.
- On-device ONNX processing for the currently supported UVR MDX-Net style model.
- Model management inside the app: download from a preset URL, download from a custom URL, or import a local ONNX file.
- Separated cache management with progress, reuse, cleanup, and fallback handling.
Model files are not bundled in the APK. When no local model is installed, the app asks the user to download or import one. The app displays a SHA-256 comparison for the preset model as guidance; a mismatch is shown to the user but does not block use. Users are responsible for checking the license and suitability of any model file they download or import.
- ποΈ Local Source Separation Playback β Split supported songs into separated playback caches and blend between original/stem output.
- πΌ Automatic Lyrics Download & Editing β Automatically fetch, sync, and edit lyrics with ease.
- π¬ Word-by-Word Synced Lyrics β Enjoy immersive real-time lyric playback with word-level timing.
- π Translated Lyrics Support β Display dual-language lyrics via TTML or LRC with translations.
- π Built-in Equalizer β Powerful EQ with up to 15 fully configurable bands and customizable profiles.
- π§ AutoEq Support β Import professionally tuned headphone correction profiles for the most accurate sound possible.
- π Gapless Playback β Smooth transitions between songs with zero interruption.
- π§ Smart Playlists β Auto-generated lists like Recently Played, Most Played, and History.
- π Native Scrobbling β Seamlessly sync your listening history with Last.fm and ListenBrainz.
- π§ Bluetooth & Headset Controls β Manage playback easily via connected devices.
- π Android Auto Integration β Full hands-free experience on the road.
- π¨ Material You Design β Dynamic theming for a modern and personal interface.
- π Folder Browsing β Play songs directly from any folder.
- β° Sleep Timer β Automatically stop playback after a set time.
- π§© Widgets β Lock screen and home screen controls for quick access.
- π Tag Editor β Edit song metadata such as title, artist, and album info.
- π ReplayGain Support β Maintain consistent volume across all tracks.
- πΌοΈ Automatic Artist Images β Download artist artwork for a polished library look.
- π« Library Filtering β Easily exclude or include folders with blacklist/whitelist options.
Booming SS builds are published from this fork only. Use the fork's GitHub releases for installable APKs, or GitHub Actions artifacts for CI builds.
| Layer | Technology |
|---|---|
| π§ Audio Engine | Media3 ExoPlayer |
| π§± Architecture | MVVM + Repository Pattern |
| πΎ Persistence | Room Database + DataStore + SharedPreferences |
| βοΈ Dependency Injection | Koin |
| π§΅ Async | Kotlin Coroutines & Flow |
| π§© UI | Android Views + Jetpack Compose (hybrid) |
| πΌοΈ Image Loading | Coil 3 |
| π¨ Design | Material 3 / Material You |
| ποΈ Source Separation | ONNX Runtime |
| π£οΈ Language | Kotlin |
- π¦ Independent library scanner (no MediaStore dependency)
- π¨ Multi-artist support (split & index properly)
- π΅ Improved genre handling
- π Last.fm integration (import/export playback data)
- πΏ Enhanced artist pages (separate albums and singles visually)
- π Jellyfin & Navidrome integration
-
π Requested Permissions
What the app needs and why -
π Android Auto Setup
How to enable and troubleshoot -
π§ Supported Formats
Compatible audio formats -
π¬ Community
Users and contributors -
π Translations
Help us translate Booming Music into your language -
β FAQ
Common questions
Booming SS is maintained as a source-separation flavored fork of Booming Music. Source-separation issues and pull requests should be opened in this fork. For bugs that reproduce in the original app without source-separation changes, please also consider reporting them upstream.
Booming Music is open-source β contributions are always welcome! Check the Contributing Guide for details.
If you enjoy the app or want to support its development, give the repo a β β it really helps! You can also:
- Open issues
- Submit pull requests
- Suggest new ideas
Translations: Managed on Hosted Weblate.
The original Booming Music project is an open-source app developed and maintained by Christians MartΓnez Alvarado with care in his spare time. If you enjoy Booming Music or this source-separation fork, please consider supporting the original author to help cover development costs and make continued work on Booming Music sustainable.
Support for the original author is greatly appreciated and helps keep Booming Music moving forward.
Booming SS is based on Booming Music by Christians MartΓnez Alvarado and contributors.
Inspired by Retro Music Player. Also thanks to:
The preset source separation model URL references the UVR_MDXNET_9482.onnx
asset from the k2-fsa/sherpa-onnx source-separation-models release. The model
file is not redistributed in this repository's APK builds.
GNU General Public License - Version 3
Copyright (C) 2025 Christians MartΓnez Alvarado
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.