{"id":44755971,"url":"https://github.com/mardous/boomingmusic","last_synced_at":"2026-05-03T16:01:51.548Z","repository":{"id":288984795,"uuid":"967726102","full_name":"mardous/BoomingMusic","owner":"mardous","description":"Clean, fast, and Material-driven music player with powerful features for Android.","archived":false,"fork":false,"pushed_at":"2026-05-01T15:06:33.000Z","size":33974,"stargazers_count":180,"open_issues_count":71,"forks_count":14,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-05-01T17:11:29.109Z","etag":null,"topics":["android","android-music-player","audio","foss","koin","kotlin","lyrics","material-ui","material3","media","media3","multimedia","music","music-player","mvvm-android","offline"],"latest_commit_sha":null,"homepage":"https://boomingmusic.vercel.app/","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mardous.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"ko_fi":"christiaam","custom":["https://www.paypal.me/christiaam"]}},"created_at":"2025-04-16T22:51:10.000Z","updated_at":"2026-05-01T15:06:37.000Z","dependencies_parsed_at":"2026-04-23T01:03:35.261Z","dependency_job_id":"90ccf52c-08f4-402c-b50b-98dafb734ea7","html_url":"https://github.com/mardous/BoomingMusic","commit_stats":null,"previous_names":["mardous/boomingmusic","projectorbital/boomingmusic"],"tags_count":55,"template":false,"template_full_name":null,"purl":"pkg:github/mardous/BoomingMusic","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mardous%2FBoomingMusic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mardous%2FBoomingMusic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mardous%2FBoomingMusic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mardous%2FBoomingMusic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mardous","download_url":"https://codeload.github.com/mardous/BoomingMusic/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mardous%2FBoomingMusic/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32575115,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T06:36:36.687Z","status":"ssl_error","status_checked_at":"2026-05-03T06:36:09.306Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","android-music-player","audio","foss","koin","kotlin","lyrics","material-ui","material3","media","media3","multimedia","music","music-player","mvvm-android","offline"],"created_at":"2026-02-16T00:11:41.483Z","updated_at":"2026-05-03T16:01:51.543Z","avatar_url":"https://github.com/mardous.png","language":"Kotlin","funding_links":["https://ko-fi.com/christiaam","https://www.paypal.me/christiaam"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"metadata/en-US/images/icon.png\" width=\"160\" height=\"160\" alt=\"Booming Music icon\"\u003e\n\n# 🎵 Booming Music\n\n### Modern design. Pure sound. Fully yours.\n\n[![Platform](https://img.shields.io/badge/Platform-Android-green.svg?style=for-the-badge\u0026logo=android)](https://android.com/)\n[![API](https://img.shields.io/badge/API-26%2B-green.svg?\u0026style=for-the-badge\u0026logo=android)](https://android-arsenal.com/api?level=26)\n[![Latest Release](https://img.shields.io/github/v/release/mardous/BoomingMusic?style=for-the-badge\u0026label=Release\u0026logo=github)](https://github.com/mardous/BoomingMusic/releases/latest)\n[![Pre-Release](https://img.shields.io/github/v/release/mardous/BoomingMusic?style=for-the-badge\u0026include_prereleases\u0026logo=github\u0026label=Pre-release)](https://github.com/mardous/BoomingMusic/releases)\n[![F-Droid version](https://img.shields.io/f-droid/v/com.mardous.booming?style=for-the-badge\u0026label=F-Droid\u0026logo=fdroid)](https://f-droid.org/packages/com.mardous.booming/)\n[![License: GPL v3](https://img.shields.io/github/license/mardous/BoomingMusic?style=for-the-badge\u0026color=orange\u0026label=License\u0026logo=gnu)](LICENSE.txt)\n[![Contributor Covenant](https://img.shields.io/badge/Contributor_Covenant-2.1-4baaaa.svg?style=for-the-badge\u0026logo=contributorcovenant)](CODE_OF_CONDUCT.md)\n[![Telegram Channel](https://img.shields.io/badge/Telegram-Join_Chat-blue?style=for-the-badge\u0026logo=telegram)](https://t.me/mardousdev)\n[![Downloads](https://img.shields.io/github/downloads/mardous/BoomingMusic/total?style=for-the-badge\u0026logo=github\u0026label=Downloads)](https://github.com/mardous/BoomingMusic/releases)\n\n\u003ca href=\"https://github.com/mardous/BoomingMusic/releases\"\u003e\u003cimg src=\"assets/badge-github.png\" height=\"60\" alt=\"GitHub Release\"\u003e\u003c/a\u003e\n\u003ca href=\"https://f-droid.org/packages/com.mardous.booming/\"\u003e\u003cimg src=\"assets/badge-fdroid.png\" height=\"60\" alt=\"F-Droid\"\u003e\u003c/a\u003e\n\u003ca href=\"https://apt.izzysoft.de/packages/com.mardous.booming/\"\u003e\u003cimg src=\"assets/badge-izzyondroid.png\" height=\"60\" alt=\"IzzyOnDroid\"\u003e\u003c/a\u003e\n\u003ca href=\"https://www.openapk.net/boomingmusic/com.mardous.booming/\"\u003e\u003cimg src=\"assets/badge-openapk.png\" height=\"60\" alt=\"OpenAPK\"\u003e\u003c/a\u003e\n\u003ca href=\"https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://github.com/mardous/BoomingMusic/\"\u003e\u003cimg src=\"assets/badge-obtainium.png\" height=\"60\" alt=\"Obtainium\"\u003e\u003c/a\u003e\n\n\u003c/div\u003e\n\n## 🗂️ Table of Contents\n\n- [✨ Key Features](#-key-features)\n- [📸 Screenshots](#-screenshots)\n- [💻 Tech Stack](#-tech-stack)\n- [🧩 Roadmap](#-roadmap)\n- [🔗 Useful Links](#-useful-links)\n- [🤝 Contributing](#-contributing)\n- [🙌 Credits](#-credits)\n- [⚖️ License](#-license)\n\n## ✨ Key Features\n\n- 🎼 **Automatic Lyrics Download \u0026 Editing** – Automatically fetch, sync, and edit lyrics with ease.\n- 💬 **Word-by-Word Synced Lyrics** – Enjoy immersive real-time lyric playback with word-level timing.\n- 🌍 **Translated Lyrics Support** – Display dual-language lyrics via TTML or LRC with translations.\n- 🔊 **Built-in Equalizer** – Powerful EQ with up to 15 fully configurable bands and customizable profiles.\n- 🎧 **AutoEq Support** – Import professionally tuned headphone correction profiles for the most accurate sound possible.\n- 🔄 **Gapless Playback** – Smooth transitions between songs with zero interruption.\n- 🧠 **Smart Playlists** – Auto-generated lists like *Recently Played*, *Most Played*, and *History*.\n- 📈 **Native Scrobbling** – Seamlessly sync your listening history with **Last.fm** and **ListenBrainz**.\n- 🎧 **Bluetooth \u0026 Headset Controls** – Manage playback easily via connected devices.\n- 🚗 **Android Auto Integration** – Full hands-free experience on the road.\n- 🎨 **Material You Design** – Dynamic theming for a modern and personal interface.\n- 📂 **Folder Browsing** – Play songs directly from any folder.\n- ⏰ **Sleep Timer** – Automatically stop playback after a set time.\n- 🧩 **Widgets** – Lock screen and home screen controls for quick access.\n- 🔖 **Tag Editor** – Edit song metadata such as title, artist, and album info.\n- 🔉 **ReplayGain Support** – Maintain consistent volume across all tracks.\n- 🖼️ **Automatic Artist Images** – Download artist artwork for a polished library look.\n- 🚫 **Library Filtering** – Easily exclude or include folders with blacklist/whitelist options.\n\n## 📸 Screenshots\n\n\u003cdiv align=\"center\"\u003e\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\u003cimg src=\"metadata/en-US/images/phoneScreenshots/1.jpg\" alt=\"For You\" width=\"180\"/\u003e\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\u003cimg src=\"metadata/en-US/images/phoneScreenshots/2.jpg\" alt=\"Songs\" width=\"180\"/\u003e\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\u003cimg src=\"metadata/en-US/images/phoneScreenshots/3.jpg\" alt=\"Albums\" width=\"180\"/\u003e\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\u003cimg src=\"metadata/en-US/images/phoneScreenshots/4.jpg\" alt=\"Album View\" width=\"180\"/\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\u003cimg src=\"metadata/en-US/images/phoneScreenshots/5.jpg\" alt=\"Search\" width=\"180\"/\u003e\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\u003cimg src=\"metadata/en-US/images/phoneScreenshots/6.jpg\" alt=\"Normal\" width=\"180\"/\u003e\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\u003cimg src=\"metadata/en-US/images/phoneScreenshots/7.jpg\" alt=\"Full\" width=\"180\"/\u003e\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\u003cimg src=\"metadata/en-US/images/phoneScreenshots/8.jpg\" alt=\"Gradient\" width=\"180\"/\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\u003cimg src=\"metadata/en-US/images/phoneScreenshots/9.jpg\" alt=\"Plain\" width=\"180\"/\u003e\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\u003cimg src=\"metadata/en-US/images/phoneScreenshots/10.jpg\" alt=\"M3\" width=\"180\"/\u003e\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\u003cimg src=\"metadata/en-US/images/phoneScreenshots/11.jpg\" alt=\"Expressive\" width=\"180\"/\u003e\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\u003cimg src=\"metadata/en-US/images/phoneScreenshots/12.jpg\" alt=\"Peek\" width=\"180\"/\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\u003c/div\u003e\n\n### 💻 Tech Stack\n\n| Layer                   | Technology                                                     |\n|:------------------------|:---------------------------------------------------------------|\n| 🎧 Audio Engine         | [Media3 ExoPlayer](https://developer.android.com/media/media3) |\n| 🧱 Architecture         | MVVM + Repository Pattern                                      |\n| 💾 Persistence          | Room Database                                                  |\n| ⚙️ Dependency Injection | [Koin](https://insert-koin.io/)                                |\n| 🧵 Async                | Kotlin Coroutines \u0026 Flow                                       |\n| 🧩 UI                   | Android Views + Jetpack Compose (hybrid)                       |\n| 🖼️ Image Loading        | [Coil](https://coil-kt.github.io/coil/)                        |\n| 🎨 Design               | Material 3 / Material You                                      |\n| 🗣️ Language            | Kotlin                                                         |\n\n## 🧩 Roadmap\n\n- [ ] 📦 Independent library scanner (no MediaStore dependency)\n- [ ] 🎨 Multi-artist support (split \u0026 index properly)\n- [ ] 🎵 Improved genre handling\n- [ ] 🔁 Last.fm integration (import/export playback data)\n- [ ] 💿 Enhanced artist pages (separate albums and singles visually)\n- [ ] 🌐 Jellyfin \u0026 Navidrome integration\n\n## 🔗 Useful Links\n\n- 🔐 **[Requested Permissions](https://github.com/mardous/BoomingMusic/wiki/Advanced-Info#-permissions)**  \n  What the app needs and why\n\n- 🚘 **[Android Auto Setup](https://github.com/mardous/BoomingMusic/wiki/Advanced-Info#-android-auto-setup)**  \n  How to enable and troubleshoot\n\n- 🎧 **[Supported Formats](https://github.com/mardous/BoomingMusic/wiki/Advanced-Info#-supported-formats)**  \n  Compatible audio formats\n\n- 💬 **[Community](https://github.com/mardous/BoomingMusic/wiki/Community)**  \n  Users and contributors\n\n- 🌐 **[Translations](https://hosted.weblate.org/projects/booming-music/)**  \n  Help us translate Booming Music into your language\n\n- ❓ **[FAQ](https://github.com/mardous/BoomingMusic/wiki/FAQ)**  \n  Common questions\n\n## 🤝 Contributing\n\nBooming Music is open-source — contributions are **always welcome!**\nCheck the [Contributing Guide](CONTRIBUTING.md) for details.\n\nIf you enjoy the app or want to support its development, give the repo a ⭐ — it really helps!\nYou can also:\n- Open issues\n- Submit pull requests\n- Suggest new ideas\n\n**Translations:** Managed on [Hosted Weblate](https://hosted.weblate.org/projects/booming-music/).\n\n[![Translation Status](https://hosted.weblate.org/widget/booming-music/horizontal-auto.svg)](https://hosted.weblate.org/projects/booming-music/)\n\n## 💖 Support Development\n\nBooming Music is an open-source project developed and maintained with passion in my spare time.\nIf you enjoy the app and the free features it offers, please consider supporting me to help cover\ndevelopment costs and dedicate more time to new features.\n\nYour support is greatly appreciated and keeps me motivated to continue improving Booming Music!\n\n\u003cdiv align=\"center\"\u003e\n\n\u003ca href=\"https://ko-fi.com/christiaam\" target=\"_blank\"\u003e\n\u003cimg src=\"https://storage.ko-fi.com/cdn/brandasset/v2/support_me_on_kofi_red.png\" alt=\"Support me on Ko-fi\" style=\"border: 0px; height: 40px;\" /\u003e\n\u003c/a\u003e\n\n### ❤️ Supporters\n\n**mbeezy** (first donor)\n\u003cbr/\u003e\n**[KKTweex](https://github.com/Qoojoe)**\n\n\u003c/div\u003e\n\n## 🙌 Credits\n\nInspired by [Retro Music Player](https://github.com/RetroMusicPlayer/RetroMusicPlayer).\nAlso thanks to:\n\n- [AMLV](https://github.com/dokar3/amlv)\n- [LRCLib](https://lrclib.net/)\n- [Better Lyrics](https://better-lyrics.boidu.dev/)\n- [SimpMusic Lyrics](https://github.com/maxrave-dev/SimpMusic)\n- [Alex](https://github.com/Paxsenix0)\n\n## ⚖️ License\n\n```\nGNU General Public License - Version 3\n\nCopyright (C) 2025 Christians Martínez Alvarado\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this program.  If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n```\n\n---\n\n\u003cp align=\"center\"\u003e\u003ca href=\"#readme\"\u003e⬆️ Back to top\u003c/a\u003e\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmardous%2Fboomingmusic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmardous%2Fboomingmusic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmardous%2Fboomingmusic/lists"}