Skip to content
Β 
Β 

Repository files navigation

Booming SS icon

🎡 Booming SS

A Booming Music fork with local source separation playback.

Latest Release Upstream License: GPL v3 Contributor Covenant

Booming SS GitHub Release

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.

πŸ—‚οΈ Table of Contents

🎚️ Source Separation Fork

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.

✨ Key Features

  • 🎚️ 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.

πŸ“Έ Screenshots

For You Songs Albums Album View
Search Normal Full Gradient
Plain M3 Expressive Peek

πŸ“₯ Download & Install

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.

Source Details
GitHub Releases Direct Booming SS APK downloads

πŸ’» Tech Stack

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

🧩 Roadmap

  • πŸ“¦ 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

πŸ”— Useful Links

🀝 Contributing

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.

Translation Status

πŸ’– Support Development

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.

Support Christians MartΓ­nez Alvarado on Ko-fi

❀️ Supporters

mbeezy
KKTweex
FabiRich
Bloodaxe
Bernhard
Andreas Hirth
Revolver327
Peter Smith
Michele Simoncelli

πŸ™Œ Credits

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.

βš–οΈ License

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/>.

⬆️ Back to top

About

A Booming Music fork with local source separation playback. Booming Music is a Clean, fast, and Material-driven music player with powerful features for Android.

Resources

Code of conduct

Contributing

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages