{"id":34928893,"url":"https://github.com/rvarunrathod/HiFidelity","last_synced_at":"2025-12-31T21:00:42.111Z","repository":{"id":326429557,"uuid":"1102605468","full_name":"rvarunrathod/HiFidelity","owner":"rvarunrathod","description":"A native macOS offline audiophile music player build with BASS audio library and Taglib","archived":false,"fork":false,"pushed_at":"2025-12-19T17:31:35.000Z","size":174135,"stargazers_count":97,"open_issues_count":2,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-22T06:10:20.679Z","etag":null,"topics":["audio-player","audiophile","bass-library","macos","music","music-player","offline-music-player","swift","swiftui","taglib"],"latest_commit_sha":null,"homepage":"https://rvarunrathod.github.io/HiFidelity/","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rvarunrathod.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"rvarunrathod"}},"created_at":"2025-11-23T18:56:22.000Z","updated_at":"2025-12-21T11:45:23.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/rvarunrathod/HiFidelity","commit_stats":null,"previous_names":["rvarunrathod/hifidelity"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/rvarunrathod/HiFidelity","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rvarunrathod%2FHiFidelity","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rvarunrathod%2FHiFidelity/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rvarunrathod%2FHiFidelity/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rvarunrathod%2FHiFidelity/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rvarunrathod","download_url":"https://codeload.github.com/rvarunrathod/HiFidelity/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rvarunrathod%2FHiFidelity/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28147503,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-31T02:00:06.200Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio-player","audiophile","bass-library","macos","music","music-player","offline-music-player","swift","swiftui","taglib"],"created_at":"2025-12-26T15:00:36.893Z","updated_at":"2025-12-31T21:00:42.105Z","avatar_url":"https://github.com/rvarunrathod.png","language":"Swift","readme":"# HiFidelity\n\u003cimg width=\"170\" src=\"./HiFidelity/Assets.xcassets/AppIcon.appiconset/Icon-macOS-Dark-512x512@1x.png\" alt=\"HiFidelity App Icon\" align=\"left\"/\u003e\n\n\u003cdiv\u003e\n\u003ch3\u003eHiFidelity\u003c/h3\u003e\n\u003cp\u003eA modern, offline-first audiophile music player for macOS with high-fidelity audio playback\u003c/p\u003e\n\u003ca href=\"https://github.com/rvarunrathod/HiFidelity/releases/latest\"\u003e\u003cimg src=\"docs/assets/macos_download.png\" width=\"140\" alt=\"Download for macOS\"/\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n\u003cbr/\u003e\u003cbr/\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/rvarunrathod/HiFidelity/releases\"\u003e\n    \u003cimg alt=\"GitHub Downloads (all assets, all releases)\" src=\"https://img.shields.io/github/downloads/rvarunrathod/HiFidelity/total?label=Downloads\u0026style=flat-square\u0026color=blue\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/rvarunrathod/HiFidelity/blob/main/LICENSE\"\u003e\n    \u003cimg alt=\"License\" src=\"https://img.shields.io/github/license/rvarunrathod/HiFidelity?label=License\u0026style=flat-square\u0026color=00796b\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/rvarunrathod/HiFidelity/releases/latest\"\u003e\n    \u003cimg alt=\"Latest Release\" src=\"https://img.shields.io/github/v/release/rvarunrathod/HiFidelity?label=Latest%20Release\u0026style=flat-square\u0026color=00796b\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/rvarunrathod/HiFidelity/\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/platform-macOS-blue.svg?label=Platform\u0026style=flat-square\u0026logo=apple\" alt=\"Platform\"/\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/rvarunrathod/HiFidelity/stargazers\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/⭐%20Give%20a%20Star-Support%20the%20project-orange?style=for-the-badge\" alt=\"Give a Star\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\n\n![HiFidelity Music Player](docs/images/musicPlayer.png)\n\n\n---\n\n## Guide for DMG Installation\n\n\u003e [!IMPORTANT]\n\u003e  \n\u003e 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.*\n\u003e\n\u003e ## Solution\n\u003e you have to bypass Gatekeeper for this (I don't want to pay apple for opensource apps)\n\u003e This will solve the occupation issue\n\u003e \n\u003e ` xattr -d com.apple.quarantine /Applications/HiFidelity.app` \n\n## ✨ Features\n\n- Powered by the BASS (un4seen) audio library for professional-grade audio quality and TagLib for meta-data reading\n- Support for 10+ audio formats including lossless and high-resolution files\n  - **Lossless \u0026 Hi-Res**: FLAC, OGA, WAV, AIFF, AIF, APE, WV, TTA, DFF, DSF  \n  - **Compressed**: MP3, MP2, AAC, OGG, OPUS, M4A, M4B, M4P, MP4, M4V, MPC  \n  - **Specialized**: CAF, WEBM, SPX\n- **Bit-perfect playback** with sample rate synchronization and Obtain Exclusive Access of audio device **(Hog mode)**\n- **Gapless Playback**: Seamless transitions between tracks with no silence or interruption\n- **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 -\u003e scan for track/album/artists -\u003e press refresh button to load calculated value)\n- Built-in equalizer with customizable presets\n- Browse by tracks, albums, artists, or genres\n- **Smart Recommendations**: Auto play functionality, you don't have to think what to play next\n- **Lyrics Support**:\n  - Download lyrics directly within the app from [lrclib](https://lrclib.net/)\n  - Real-time line-by-line lyrics highlighting\n- **Mini Player**: Compact floating window with integrated queue and lyrics panels\n- **Audio device change** option within UI\n- **Advanced Search**: Find tracks instantly across your entire library with FTS5 (Rebuild search index if you not able to see any results: Settings -\u003e Advanced -\u003e Rebuild FTS)\n- **Playback History**: Keep track of what you've listened to\n- **Favorites**: Mark and organize your favorite tracks\n- Import playlist with m3u or Import Folder as playlist\n- Menu bar controls and Now Playing info\n\n## 🔮 Upcoming Features\n\n- ~~Automatic scanning and updating of the music library~~ ( ✅ [1.0.4](https://github.com/rvarunrathod/HiFidelity/releases/tag/v1.0.4) )\n- ~~A compact Mini Player mode~~ ( ✅ [1.0.5](https://github.com/rvarunrathod/HiFidelity/releases/tag/v1.0.5) )\n- ~~Let user change audio output device from UI~~ ( ✅ [1.0.6](https://github.com/rvarunrathod/HiFidelity/releases/tag/v1.0.6) ) \n- ~~ReplayGain and volume normalization~~ ( ✅ [1.0.8](https://github.com/rvarunrathod/HiFidelity/releases/tag/v1.0.8) ) \n- Audio visualizers (waveform / spectrum)\n- ... \n\n## 📷 Screenshots \u0026 Demos\n\n#### Audio Features\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"docs/images/Equalizer.png\" alt=\"Equalizer\" width=\"600\" style=\"margin: 10px;\"\u003e\n\u003c/div\u003e\n\n\n\n#### Smart Features \u0026 Demos\n\u003cdiv align=\"center\"\u003e\n  \u003ctable border=\"0\"\u003e\n    \u003ctr\u003e\n      \u003ctd width=\"50%\" align=\"center\"\u003e\n        \u003cb\u003eMini Player\u003c/b\u003e\u003cbr\u003e\n        \u003cvideo src=\"https://github.com/user-attachments/assets/9f7c32b4-80f8-41e7-90a1-afa1394e65e1\" controls width=\"100%\"\u003e\u003c/video\u003e\n      \u003c/td\u003e\n      \u003ctd width=\"50%\" align=\"center\"\u003e\n        \u003cb\u003eLyrics Support\u003c/b\u003e\u003cbr\u003e\n        \u003cvideo src=\"https://github.com/user-attachments/assets/03c41edd-96ef-4c41-8b21-2bba1f59e535\" controls width=\"100%\"\u003e\u003c/video\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd width=\"50%\" align=\"center\"\u003e\n        \u003cb\u003eAdvanced Search\u003c/b\u003e\u003cbr\u003e\n        \u003cvideo src=\"https://github.com/user-attachments/assets/eded563a-a699-46eb-82c6-3e8a4c0cd019\" controls width=\"100%\"\u003e\u003c/video\u003e\n      \u003c/td\u003e\n      \u003ctd width=\"50%\" align=\"center\"\u003e\n        \u003cb\u003eAutoplay Queue\u003c/b\u003e\u003cbr\u003e\n        \u003cvideo src=\"https://github.com/user-attachments/assets/ef5f1d09-e1fb-4369-b8ac-1c7feafaab59\" controls width=\"100%\"\u003e\u003c/video\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\u003c/div\u003e\n\n## 🛠 Requirements\n\n- **macOS 14.0** (Sonoma) or later\n- Apple Silicon or Intel Macs \n\n## 📥 Installation\n\n#### 🍺 Install via Homebrew (Recommended)\n\n```bash\nbrew tap rvarunrathod/tap\nbrew install --cask rvarunrathod/tap/hifidelity\n```\n\n#### Download for macOS\n  \n- You can download the latest signed macOS build from the Releases page:\n- **[Download Latest Release](https://github.com/rvarunrathod/HiFidelity/releases/latest)**\n- After downloading, move **HiFidelity.app** to your **Applications** folder.\n  \n#### First Launch?\n\n1. Open **Settings → Library** Add folders containing your music files.\n2. HiFidelity will automatically scan and import your music.\n3. Start enjoying your music collection!\n\n## ⚡ Development \n\n- Make sure you’re running macOS 14 or later\n- Clone the repository\n- Open `HiFidelity.xcodeproj` in Xcode 15 or later\n\n---\n\n#### Privacy \u0026 Security\n\n- **No Internet Required**: Works completely offline\n- **No Data Collection**: This app don't collect or transmit any data\n- **Sandboxed**: Follows macOS security best practices\n\n#### Acknowledgments\n\n- [**BASS Audio Library**](https://www.un4seen.com/): Professional audio engine\n- [**TagLib**](https://taglib.org/): Metadata extraction\n- [**GRDB**](https://github.com/groue/GRDB.swift): Fast, reliable local database\n- [**Sparkle**](https://github.com/sparkle-project/Sparkle): A software update framework for macOS\n- [**Lrclib**](https://lrclib.net/): Utility for mass-downloading LRC synced lyrics for your offline music library. \n\n---\n\n\u003cdiv align=\"center\"\u003e\n\u003ch3\u003eBuilt with ❤️ for music lovers who value quality, privacy, and control\u003c/h3\u003e\n\u003c/div\u003e\n","funding_links":["https://github.com/sponsors/rvarunrathod"],"categories":["Audio"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frvarunrathod%2FHiFidelity","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frvarunrathod%2FHiFidelity","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frvarunrathod%2FHiFidelity/lists"}