HiFi

Open-source, ad-free music streaming client and player built with Compose Multiplatform.

---

HiFi is a lightweight music player and streaming client for Android and Windows. It connects directly to public music streaming sources to provide an ad-free listening experience with synchronized lyrics, offline audio caching, and a 10-band equalizer.

Downloads

Official builds are available on the Releases page.

OS	Package	Arch	Details
Windows	HiFi-2.3.1-Setup.exe	x64	Inno Setup installer with Desktop & Start Menu shortcuts
Android	HiFi-arm64-v8a.apk	ARM64	Recommended for most modern Android devices
Android	HiFi-universal.apk	All	Universal package compatible with all Android devices
Android	HiFi-armeabi-v7a.apk	ARMv7	Legacy 32-bit Android devices
Android	HiFi-x86_64.apk	x86_64	Android emulators & ChromeOS

Screenshots

Overview of Features

Core Audio & Streaming

• Ad-free playback backed by YouTube Music data endpoints.
• Persistent background playback service with Android media notifications.
• Local audio caching for offline playback.
• Hardware-accelerated audio pipeline via Google AndroidX Media3 (Android) and libmpv (Desktop).
• 10-band equalizer with bass boost and custom presets.
• Spotify Canvas video background integration.

Lyrics & Metadata

• Real-time synchronized lyrics from LRCLIB, Spotify, and YouTube transcripts.
• Multi-language lyrics translation.
• SponsorBlock integration to automatically skip non-music segments.
• Return YouTube Dislike integration.

Library & Integration

• Top Charts, Moods, Genres, and Podcast directories.
• Custom local playlists and YouTube Music account synchronization.
• Android Auto support with voice search and queue controls.
• Configurable sleep timer.

Privacy

• No third-party telemetry, trackers, or advertising SDKs.
• Direct network requests between client and streaming servers.

Tech Stack

• Language: Kotlin 2.4
• UI: Compose Multiplatform (Jetpack Compose / Material 3 Expressive)
• Audio Engine: AndroidX Media3 (Android) / libmpv (Desktop)
• Persistence: AndroidX Room (bundled SQLite) + DataStore
• Networking: Ktor Client, OkHttp
• DI: Koin
• Packaging: AGP (Android) / Inno Setup & WiX (Windows)

Project Structure

HiFi/
├── androidApp/       # Android application module & platform services (Media3)
├── desktopApp/       # Windows desktop application module & entry point
├── composeApp/       # Shared Compose Multiplatform UI, screens & ViewModels
├── core/
│   ├── data/         # Repository implementations, caching & network clients
│   ├── domain/       # Business logic, use cases & domain models
│   ├── database/     # AndroidX Room SQLite database & DAOs
│   └── service/      # Audio playback engines & streaming scrapers
└── scripts/          # Packaging & build scripts (Inno Setup)

Building

Prerequisites

• JDK 21+
• Android SDK (API 36)
• Inno Setup 6 (Windows packaging)

Build APK

./gradlew :androidApp:assembleRelease

Output: androidApp/build/outputs/apk/release/

Build Windows Installer

# Generate unpacked application directory
./gradlew :desktopApp:packageAppImage

# Compile installer executable
iscc scripts/windows/HiFi-setup.iss

Output: release_builds/windows/HiFi-2.3.1-Setup.exe

FAQ & Troubleshooting

Windows: "Windows protected your PC" during installation

Because HiFi is an independent open-source application and does not use an expensive commercial code-signing certificate, Windows SmartScreen may show a warning. Click "More info" and then select "Run anyway" to proceed with the installation.

Managing storage & cache size

HiFi caches streamed audio for responsive offline playback. You can customize the maximum cache limit or clear cached data at any time via Settings > Storage & Cache.

Updating HiFi

HiFi delivers updates directly via GitHub Releases. Navigate to Settings > Check for update to check and download new releases.

Maintainer

Syafril — syafril.pages.dev
Repository: github.com/saferill/HiFi

Acknowledgements

HiFi is an open-source project based on and forked from SimpMusic by maxrave-dev, licensed under the GNU General Public License v3.0.

Special thanks to:

• maxrave-dev and all SimpMusic contributors for the foundational architecture and player features.
• The Metrolist team for the Listen Together protocol and public relay service.
• The open-source libraries that make this project possible (viewable in-app via Settings > Third-party libraries).

License

This project is licensed under the GNU General Public License v3.0.