Skip to content

4aya/hipotify

 
 

Repository files navigation

🎶 Hipotify

Hipotify is a free, open-source, and ad-free music player for Android based on Tidal with Hi-Res sound. It has a clean interface similar to Spotify, built with Flutter for a premium native experience.

Features

  • Ad-Free Listening: Stream directly from Tidal without interruptions.
  • 💿 Lossless Audio: Support for FLAC and Hi-Res sound quality.
  • 🎧 Huge Catalogue: Powered by the full TIDAL library and HiFi APIs.
  • 🔲 Clean UI: Premium glassmorphism aesthetic similar to Spotify.
  • 🎵 Synced Lyrics: Lyrics with tap-to-seek functionality.
  • 💾 Smart Downloads: Export songs and albums as lossless .flac files with full metadata (cover art, track numbers, release dates).
  • 📁 Local Storage: Playlists, liked songs, and recently listened history saved locally via Hive.
  • 🔎 Search: Find media and sort by album, track, artist, or playlist.
  • 📊 Stats for Nerds: Real-time technical details (bit depth, sample rate, etc.).
  • 📡 Chromecast: Stream to your TV with synchronized lyrics.
  • 📶 Audio Quality Selector: Switch between Low, High, Lossless, and Hi-Res audio qualities.

⚙️ How It Works

Hipotify acts as a mobile frontend that fetches lossless audio directly from TIDAL.

  1. You search for a song.
  2. Hipotify sends the query to a HiFi API.
  3. The API returns a direct TIDAL lossless stream link.
  4. Hipotify plays the audio using a high-performance playback engine.

🔗 Credits & Related Projects

  • hifi - Tidal Music integration for Subsonic/Jellyfin/Plexamp
  • tidal-ui - Original Inspiration for the synced lyrics and UI logic
  • hifi-api - API that fetches the streams
  • spofree - Inspiration for the feature set and design goals

🔎 API List

The following public HiFi API instances can be used in the app settings:

Provider Instance URL
squid.wtf https://triton.squid.wtf
squid.wtf https://aether.squid.wtf
squid.wtf https://zeus.squid.wtf
squid.wtf https://kraken.squid.wtf
lucida https://wolf.qqdl.site
lucida https://maus.qqdl.site

🚀 Setup

  1. Clone the repository.
  2. Run flutter pub get to install dependencies.
  3. Configure your API base URL in the app settings.

🤖 Build Instructions

Android

  1. Install Flutter SDK.
  2. Setup Android SDK.
  3. Build options:
    • APK: flutter build apk --release
    • Split APKs: flutter build apk --split-per-abi
    • App Bundle: flutter build appbundle
  4. Output: build/app/outputs/flutter-apk/

iOS

Important

iOS builds require macOS with Xcode installed.

  1. Run flutter pub get.
  2. Run cd ios && pod install && cd ...
  3. Build: flutter build ios --release.
  4. Output: build/ios/iphoneos/Runner.app (or .ipa).

Disclaimer: This project does not promote piracy. The use of third-party APIs is at the user's own responsibility. It is highly recommended to host your own instance of hifi-api for personal use.

About

free, open-source, and ad-free music player based on Tidal with Hi-Res sound

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Svelte 33.5%
  • Dart 24.3%
  • TypeScript 23.6%
  • HTML 13.7%
  • CSS 1.2%
  • CMake 0.9%
  • Other 2.8%