![Hivefy Banner](./assets/docs/fullbanner.png)

<h1 align="center">Hivefy 🎧</h1>

<p align="center">

  <!-- 🔹 GitHub Downloads -->
  <a href="https://github.com/Harish-Srinivas-07/hivefy/releases/latest">
    <img alt="GitHub Downloads" src="https://img.shields.io/github/downloads/Harish-Srinivas-07/hivefy/total?label=Downloads(Git)">
  </a>

  <!-- 🔹 SourceForge Downloads -->
  <a href="https://sourceforge.net/projects/hivefy/files/">
    <img alt="SourceForge Downloads" src="https://img.shields.io/sourceforge/dt/hivefy?label=Downloads(SF)">
  </a>

  <!-- 🔹 GitHub Latest Release -->
  <a href="https://github.com/Harish-Srinivas-07/hivefy/releases/latest">
    <img alt="GitHub Release" src="https://img.shields.io/github/v/release/Harish-Srinivas-07/hivefy">
  </a>
  <!-- 🔹 Built With / Platform / Open Source -->
  <img alt="Flutter" src="https://img.shields.io/badge/Built%20With-Flutter-02569B">
  <img alt="Android" src="https://img.shields.io/badge/Platform-Android-3DDC84?logo=android&logoColor=white">
  <img alt="Open Source" src="https://img.shields.io/badge/Open%20Source-Yes-brightgreen">
  
</p>

**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**. 🎵

<a href="https://github.com/Harish-Srinivas-07/hivefy/releases/latest">
  <img alt="OSS Rising Star Badge for Hivefy" src="https://b.sf-syn.com/badge_img/3922596/oss-rising-star-black" width="170">
</a>

<h3>Download for Android 😍</h3>

<!-- GitHub button -->
<p>
  <a href="https://github.com/Harish-Srinivas-07/hivefy/releases" target="_blank">
    <img alt="Github build" src="https://raw.githubusercontent.com/NeoApplications/Neo-Backup/034b226cea5c1b30eb4f6a6f313e4dadcbb0ece4/badge_github.png" height="60" style="vertical-align: middle;" />
  </a>
</p>

<!-- SourceForge button -->
<p>
  <a href="https://sourceforge.net/projects/hivefy/" target="_blank">
    <img alt="Download Hivefy" src="https://a.fsdn.com/con/app/sf-download-button" height="40" style="vertical-align: middle;" />
  </a>
</p>


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

<p align="center">
  <img src="./assets/docs/pic1.png" width="230" />
  <img src="./assets/docs/pic2.png" width="230" />
  <img src="./assets/docs/pic3.png" width="230" />
</p>
<p align="center">
  <img src="./assets/docs/pic4.png" width="230" />
  <img src="./assets/docs/pic5.png" width="230" />
</p>

## 🧠 Upcoming Features

- [ ] 🎼 Lyrics sync & overlay
- [ ] 🧠 AI-based recommendations
- [ ] ☁️ Cloud profile sync
- [ ] 🖥️ Windows app support
- [ ] 🍏 iOS app support
- [ ] 🤝 Playlist sharing & collaboration

---
## 🌐 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

```bash
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:

```bash
# 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**.