# ๐ธ Bloomee
**A unified local and plugin-first streaming music player built with Flutter & Rust.**
**Bloomee** is an experimental, open-source music player designed to give you absolute freedom over your audio. Seamlessly mix your **local device music** with an infinite universe of streams powered by a secure, **Rust-backed plugin system**. No ads, no interruptionsโjust your tunes, your way. ๐ผ๐ต
---
> โ ๏ธ **SECURITY WARNING: BEWARE OF FAKE WEBSITES!** โ ๏ธ
> Due to the app's popularity, several unofficial websites claim to be the "official" Bloomee site. The ONLY official websites maintained by me are:
>
> - https://tunes.bloomeex.org
> - https://hemantkarya.github.io/BloomeeTunes/
>
> These two URLs are the only official and safe sites for Bloomee. Do not trust other websites claiming to be official โ unofficial sites may distribute modified APKs or malware. I am **not responsible** for any damage, privacy loss, or issues caused by downloading the app from third-party sources.
---
## ๐ Features & Roadmap
- [x] ๐ซ **Ad-Free Experience:** Zero interruptions, just pure music.
- [x] ๐ฆ **Plugins system:** Secure, auto-updating `.bex` plugin system for endless music sources.
- [x] ๐ **Local Music:** Play your local offline music seamlessly alongside online streams.
- [x] ๐ค **Karaoke-Style Lyrics:** Time-synced lyrics with manual offset adjustment.
- [x] ๐๏ธ **Audio Equalizer:** Built-in Equalizer and customizable Crossfade transitions.
- [x] ๐ **Smart Replace:** Auto-recovery finds working streams if a playlist track goes dead.
- [x] ๐ **Last.fm Scrobbling:** Automatically log your listening history (includes offline caching).
- [x] ๐ฎ **Discord Rich Presence:** Show off your current tunes on your Discord profile.
- [x] ๐ **Global Charts:** Daily updated charts from installed plugins.
- [x] ๐ฅ๏ธ **Cross-Platform:** Native media controls and shortcuts for Windows, Linux, and Android.
- [x] ๐พ **Backup & Restore:** Easily export/import your library and settings via JSON or M3U.
- [x] ๐ค **AI-Based Recommendations:** Get smarter song suggestions (Last.fm/Plugin Based).
- [x] ๐ **Multi-Language Support:** Localized app interface for global users *(Implementing more languages..)*
---
## ๐ Language Support
| Language | Native Name | Status |
|----------|------------|--------|
| ๐ฎ๐ณ Hindi | เคนเคฟเคจเฅเคฆเฅ | โ Complete |
| ๐บ๐ธ English | English | โ Complete |
| ๐ฐ๐ท Korean | ํ๊ตญ์ด | โ Complete |
| ๐ฉ๐ช German | Deutsch | โ Complete |
| ๐ช๐ธ Spanish | Espaรฑol | โ Complete |
| ๐ฏ๐ต Japanese | ๆฅๆฌ่ช | โ Complete |
| ๐จ๐ณ Chinese | ไธญๆ | โ Complete |
| ๐ซ๐ท French | Franรงais | โ Complete |
| ๐ต๐น Portuguese | Portuguรชs | โ Complete |
| ๐น๐ท Turkish | Tรผrkรงe | โ Complete |
> ๐ข All translations are fully completed and maintained, Still if you feel any language needs more thought then please feel free to open the issue.
---
๐ฅ Download & Install
Available for Android, Windows & Linux (Dev) ๐
---
## ๐ Support the Development
Bloomee is a passion project. I spend countless hours building, refining, and fixing bugs to give everyone a premium, ad-free music experience. If you love the app and want to see it grow, consider supporting my work!
Every contribution, big or small, keeps the music playing. โ๐ถ
---
## ๐ค Contribute to Bloomee
**Every note counts!** Whether you're a seasoned developer or a beginner (I am relatively new to Flutter myself!), your pull requests, bug reports, and feature suggestions are highly appreciated.
Contributing to Bloomee is a great way to learn **Flutter, clean architecture, and BLoC patterns** in a real-world codebase.
1. **Discuss:** Open an Issue first to discuss your idea.
2. **Fork & Clone:** Fork the `main` branch.
3. **Branch & Build:** Create your feature branch.
4. **Pull Request:** Submit a PR and let your code join the Bloomee symphony!
*Please read our [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.*
---
## ๐ซ Get in Touch
Have questions, feedback, or just want to say hi? Connect with me here: