Skip to content

Hivefy - Ad-free, offline-ready music streaming app with Spotify-style interface and JioSaavn API.

License

Notifications You must be signed in to change notification settings

Harish-Srinivas-07/hivefy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

28 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Hivefy Banner

Hivefy ๐ŸŽง

GitHub Downloads SourceForge Downloads GitHub Release Flutter Android Open Source

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. ๐ŸŽต

OSS Rising Star Badge for Hivefy

Download for Android ๐Ÿ˜

Github build

Download Hivefy

โš ๏ธ 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

  • ๐ŸŽผ Lyrics sync & overlay
  • ๐Ÿง  AI-based recommendations
  • โ˜๏ธ Cloud profile sync
  • ๐Ÿ–ฅ๏ธ Windows app support
  • ๐Ÿ iOS app 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

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.