Skip to content

Repository files navigation

DISCLAIMER: the public instance does not work because public hifi apis are getting banned by tidal. you can fork the repo and add your own hifi api if you want to continue using this project. Tidal has begun blocking accounts en masse starting from around now - not only users using this API but also other providers such as lucide.to. There is currently no solution for this - this includes homelab users who don't expose their API to the Internet.


🎶 SpoFree

Deploy with Vercel Deploy to Netlify

SpoFree is a free, open-source, and ad-free music player based on Tidal with Hi-Res sound. It has a clean interface similar to Spotify.

Features

  • Ad-Free Listening
  • 💿Lossless Audio
  • 🎧Huge Catalogue powered by the full TIDAL library
  • 🔲Clean UI similar to Spotify
  • 🎶Playlist Support
  • 📁Local Storage playlists, liked songs, recently listened saved via IndexDB in your browser
  • 🔎Search
  • 💾Export audio as csv or zip containing lossless .flac files
  • Sleep Timer with customizable length
  • 🔢Queue that you can save as a playlist and customize
  • 🎵Media Session API for lock screen and control center support
  • 📶Library Organized library with Playlists, Liked Songs, Saved Albums, and Followed Artists.
  • 🎵Audio Quality Selector
  • 🟥Accent Color
  • ⚙️Additional Settings
  • 📺Settings for low-end devices
  • 📲Import Playlist via Text (Artist - Title) or CSV file or from local files
  • 📥Import Spotify Playlists using this website, this is the repo
  • ❗️More features coming soon

🌐 Instances / Wrapper

Version URL Note
Official https://spo.free.nf doesnt have ssl, but it just embeds spofree.vercel.app, hosted on infinityfree
Original https://spofree.vercel.app original domain, embedded by spo.free.nf
Unofficial https://github.com/eweerfr/spofree-electron Electron wrapper for windows by eweer. Thank you for contributing!

⚙️ How It Works

SpoFree acts as a Frontend that fetches lossless audio directly from TIDAL.

How it works:

  1. You search for a song
  2. SpoFree sends the query to a HiFi API
  3. The API returns a direct TIDAL lossless stream link
  4. SpoFree plays the audio

The API instances come from open-source HiFi projects that provide public endpoints.

🤝 Contributing and Issues

Contributions are welcome. Feel free to open a Pull Request. Also please submit any bugs you find!

🔗 Related Projects

Screenshots

Audio Quality Selector and Appereance

Playlist Import and Library

Liked Songs and Extra Settings

Releases

Packages

Contributors

Languages