https://github.com/rvarunrathod/HiFidelity
A native macOS offline audiophile music player build with BASS audio library and Taglib
https://github.com/rvarunrathod/HiFidelity
audio-player audiophile bass-library macos music music-player offline-music-player swift swiftui taglib
Last synced: 4 months ago
JSON representation
A native macOS offline audiophile music player build with BASS audio library and Taglib
- Host: GitHub
- URL: https://github.com/rvarunrathod/HiFidelity
- Owner: rvarunrathod
- License: apache-2.0
- Created: 2025-11-23T18:56:22.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-12-19T17:31:35.000Z (4 months ago)
- Last Synced: 2025-12-22T06:10:20.679Z (4 months ago)
- Topics: audio-player, audiophile, bass-library, macos, music, music-player, offline-music-player, swift, swiftui, taglib
- Language: Swift
- Homepage: https://rvarunrathod.github.io/HiFidelity/
- Size: 166 MB
- Stars: 97
- Watchers: 1
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-swift-macos-apps - HiFidelity - commit/rvarunrathod/HiFidelity?style=flat&label=" /> - An offline audiophile music player built with the BASS audio library and TagLib. (Audio)
README
# HiFidelity
HiFidelity
A modern, offline-first audiophile music player for macOS with high-fidelity audio playback
---
## Guide for DMG Installation
> [!IMPORTANT]
>
> After you install the Application and try to open it, you will see message like this: *Apple could not verify “HiFidelity.app” is free of malware that may harm your Mac or compromise your privacy.*
>
> ## Solution
> you have to bypass Gatekeeper for this (I don't want to pay apple for opensource apps)
> This will solve the occupation issue
>
> ` xattr -d com.apple.quarantine /Applications/HiFidelity.app`
## ✨ Features
- Powered by the BASS (un4seen) audio library for professional-grade audio quality and TagLib for meta-data reading
- Support for 10+ audio formats including lossless and high-resolution files
- **Lossless & Hi-Res**: FLAC, OGA, WAV, AIFF, AIF, APE, WV, TTA, DFF, DSF
- **Compressed**: MP3, MP2, AAC, OGG, OPUS, M4A, M4B, M4P, MP4, M4V, MPC
- **Specialized**: CAF, WEBM, SPX
- **Bit-perfect playback** with sample rate synchronization and Obtain Exclusive Access of audio device **(Hog mode)**
- **Gapless Playback**: Seamless transitions between tracks with no silence or interruption
- **ReplayGain**: Replay Gain from metadata or EBU R128 louness normalization (turn on replayGain from audio settings) (to scan for R128 loudness, right click on track -> scan for track/album/artists -> press refresh button to load calculated value)
- Built-in equalizer with customizable presets
- Browse by tracks, albums, artists, or genres
- **Smart Recommendations**: Auto play functionality, you don't have to think what to play next
- **Lyrics Support**:
- Download lyrics directly within the app from [lrclib](https://lrclib.net/)
- Real-time line-by-line lyrics highlighting
- **Mini Player**: Compact floating window with integrated queue and lyrics panels
- **Audio device change** option within UI
- **Advanced Search**: Find tracks instantly across your entire library with FTS5 (Rebuild search index if you not able to see any results: Settings -> Advanced -> Rebuild FTS)
- **Playback History**: Keep track of what you've listened to
- **Favorites**: Mark and organize your favorite tracks
- Import playlist with m3u or Import Folder as playlist
- Menu bar controls and Now Playing info
## 🔮 Upcoming Features
- ~~Automatic scanning and updating of the music library~~ ( ✅ [1.0.4](https://github.com/rvarunrathod/HiFidelity/releases/tag/v1.0.4) )
- ~~A compact Mini Player mode~~ ( ✅ [1.0.5](https://github.com/rvarunrathod/HiFidelity/releases/tag/v1.0.5) )
- ~~Let user change audio output device from UI~~ ( ✅ [1.0.6](https://github.com/rvarunrathod/HiFidelity/releases/tag/v1.0.6) )
- ~~ReplayGain and volume normalization~~ ( ✅ [1.0.8](https://github.com/rvarunrathod/HiFidelity/releases/tag/v1.0.8) )
- Audio visualizers (waveform / spectrum)
- ...
## 📷 Screenshots & Demos
#### Audio Features
#### Smart Features & Demos
Mini Player
Lyrics Support
Advanced Search
Autoplay Queue
## 🛠 Requirements
- **macOS 14.0** (Sonoma) or later
- Apple Silicon or Intel Macs
## 📥 Installation
#### 🍺 Install via Homebrew (Recommended)
```bash
brew tap rvarunrathod/tap
brew install --cask rvarunrathod/tap/hifidelity
```
#### Download for macOS
- You can download the latest signed macOS build from the Releases page:
- **[Download Latest Release](https://github.com/rvarunrathod/HiFidelity/releases/latest)**
- After downloading, move **HiFidelity.app** to your **Applications** folder.
#### First Launch?
1. Open **Settings → Library** Add folders containing your music files.
2. HiFidelity will automatically scan and import your music.
3. Start enjoying your music collection!
## ⚡ Development
- Make sure you’re running macOS 14 or later
- Clone the repository
- Open `HiFidelity.xcodeproj` in Xcode 15 or later
---
#### Privacy & Security
- **No Internet Required**: Works completely offline
- **No Data Collection**: This app don't collect or transmit any data
- **Sandboxed**: Follows macOS security best practices
#### Acknowledgments
- [**BASS Audio Library**](https://www.un4seen.com/): Professional audio engine
- [**TagLib**](https://taglib.org/): Metadata extraction
- [**GRDB**](https://github.com/groue/GRDB.swift): Fast, reliable local database
- [**Sparkle**](https://github.com/sparkle-project/Sparkle): A software update framework for macOS
- [**Lrclib**](https://lrclib.net/): Utility for mass-downloading LRC synced lyrics for your offline music library.
---
Built with ❤️ for music lovers who value quality, privacy, and control