🗂️ Table of Contents

• ✨ Key Features
• 📸 Screenshots
• 💻 Tech Stack
• 🧩 Roadmap
• 🔗 Useful Links
• 🤝 Contributing
• 🙌 Credits
• ⚖️ License

✨ Key Features

• 🎼 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

💻 Tech Stack

Layer	Technology
🎧 Audio Engine	Media3 ExoPlayer
🧱 Architecture	MVVM + Repository Pattern
💾 Persistence	Room Database
⚙️ Dependency Injection	Koin
🧵 Async	Kotlin Coroutines & Flow
🧩 UI	Android Views + Jetpack Compose (hybrid)
🖼️ Image Loading	Coil
🎨 Design	Material 3 / Material You
🗣️ 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

• 🔐 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

🤝 Contributing

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.

💖 Support Development

Booming Music is an open-source project developed and maintained with passion in my spare time. If you enjoy the app and the free features it offers, please consider supporting me to help cover development costs and dedicate more time to new features.

Your support is greatly appreciated and keeps me motivated to continue improving Booming Music!

🙌 Credits

Inspired by Retro Music Player. Also thanks to:

• AMLV
• LRCLib
• Better Lyrics
• Lyrically API (by Alex)

⚖️ 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