🎧 Hivefy — Open Source Music Experience

Hivefy is a Spotify-inspired, ad-free, and offline-ready music app built with Flutter using the unofficial JioSaavn API.
Explore trending charts, languages, albums, and playlists — beautifully designed for a true music experience. 🎵

Download

👉 Download the Latest APK

Enable “Install from unknown sources” in your device settings to install.

✨ Features

🎨 Modern Experience

• Spotify-inspired UI & animations
• Dynamic Material You theming
• Adaptive icons and typography using SpotifyMix

🎧 Powerful Player

• Background playback via audio_service
• Swipe gestures & visual seek controls
• Animated miniplayer → full player transition

💾 Offline-First

• Download and store music locally (albums / playlists / songs)
• Automatic cleanup for invalid files
• Background download notifications

🔍 Smart Search & Library

• Unified global search (songs, albums, artists, playlists)
• Persistent library powered by Hive DB
• Works perfectly without Internet

⚙️ Settings & Customization

• Server selector (Main / Backup / Mirror)
• Cache management & download monitor
• Toggle theme, clear storage, and more

🖼️ Screenshots

🧠 Upcoming Features

• 🎼 Lyrics sync & overlay
• 🧠 AI-based recommendations
• ☁️ Cloud profile sync
• 🖥️ Windows & Linux support
• 🤝 Playlist sharing & collaboration

🚀 Getting Started

Prerequisites

• Flutter SDK (>=3.7.2)
• Android Studio / VS Code setup for Flutter
• Java JDK 17+ (for app signing)
• Device / emulator running Android 7.0+

Setup & Run

git clone https://github.com/Harish-Srinivas-07/hivefy.git
cd hivefy
flutter pub get
flutter run

🧩 Tech Stack

💡 Developer Notes

• Debug builds use the DebugServer endpoint (no signing required)
• Release builds are automatically optimized with ProGuard
• All data models include toJson and fromJson with unescape normalization
• You can modify backend logic under services/ and UI flows under views/

❤️ Contributing

We welcome PRs and ideas from everyone.
If you’d like to add a feature or fix a bug:

# Fork & branch
git checkout -b feature/my-awesome-feature

# Make changes
flutter pub get
flutter run

Then open a Pull Request — we’ll review it together 🎵

⚠️ Disclaimer

Hivefy uses the unofficial JioSaavn API solely for educational and research purposes.
The app does not host or distribute any copyrighted media.
All rights belong to their respective owners.

⭐ Star the Repo

If Hivefy inspired you, show your support by starring ⭐ it on GitHub!
Let’s build the next generation of open music apps — for everyone, ad-free.