Hivefy Banner

Hivefy 🎧

Hivefy is a FOSS, Spotify inpired, ad-free, and offline-ready music app built with Flutter using the unofficial JioSaavn API.
Explore trending charts, albums, playlists, and multi-language content — all open-source, privacy-respecting, and fully customizable. 🎵

Download for Android 😍

⚠️ Make sure “Install from unknown sources” is enabled in your device settings to install Hivefy.

✨ 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

🌐 Hivefy Web (New 🚀)

Hivefy is now available on the web!

👉 Live Demo: https://hivefyweb.vercel.app 👉 Open Source Repo: https://github.com/Harish-Srinivas-07/hivefyweb

Built with Next.js, Hivefy Web brings a fast, responsive, and install-free music experience directly to your browser.

✨ Highlights

🎨 Spotify-inspired UI
⚡ Lightweight & responsive
🔍 Global search
💾 Offline-first caching
🎧 PiP & Media Session support
🌍 Multi-language support

No install needed — open and start listening.

🚀 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

Category	Packages
State	`flutter_riverpod`
Audio	`just_audio`, `audio_service`, `just_audio_background`
Storage	`hive`, `shared_preferences`, `path_provider`
UI/UX	`shimmer`, `cached_network_image`, `figma_squircle`, `flashy_tab_bar2`, `readmore`
Network	`dio`, `http`, `html_unescape`
System	`flutter_local_notifications`, `disk_space_plus`, `package_info_plus`
Utils	`toastification`, `permission_handler`, `internet_connection_checker_plus`

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