Skip to content
fjennPublic

About

Free music, podcasts and audiobooks for Mac and iPhone. No ads, no account.

Resources

Contributing

Stars

4 stars

Watchers

0 watching

Forks

Repository files navigation

Spotless: music, podcasts and audiobooks. Free. No ads. No account.

A free music app for Mac and iPhone. Songs, podcasts and audiobooks, with no ads, no account and no tracking. Open source.

Latest release License: GPL-3.0 macOS 13.3 or later, iOS 17 or later

Download Spotless for Mac

Apple silicon and Intel, signed and notarized, updates itself.  ·  iPhone: sideload it now; TestFlight and the App Store are coming.
Website  ·  Support  ·  All releases  ·  Report a bug


Spotless on the Mac: Home, with a song playing

Spotless on iPhone: Home, Now Playing, a podcast episode with chapters, and Your Library

More screens

An album page on the Mac

Lyrics, search, a free audiobook, and importing playlists on iPhone

Screenshots use a made-up catalogue: the artists, albums and covers are not real.

Install on iPhone

The App Store and TestFlight are coming. Until then, sideload it with your own free Apple ID:

  1. Install SideStore or AltStore on your iPhone.
  2. Add the Spotless source: https://opena.tech/spotless/altstore.json (add to AltStore; in SideStore, open sidestore://source?url=https://opena.tech/spotless/altstore.json or paste the URL under Sources › +).
  3. Tap Install on Spotless.

Good to know: with a free Apple ID, sideloaded apps run for 7 days and are then re-signed (both tools do this on their own in the background), and at most 3 sideloaded apps can be active at once, the store app included. Needs iOS 17 or later. The IPA is also on each ios-v* release.

What it does

Spotless plays music, podcasts and audiobooks. The Mac app (Tauri + Svelte) and the iPhone app (SwiftUI) share one Rust core, so search, recommendations, the library and downloads work the same way on both.

Music

  • Search and browse songs, albums, artists, playlists, charts, moods and new releases.
  • Radio from any song, smart shuffle, and switch a song to its music video when there is one.
  • Six-band equalizer with presets, speed and pitch, reverb, crossfade and a sleep timer.
  • Downloads for offline listening, with an offline mode.

Podcasts

  • Search, follow and get a feed of new episodes. Video podcasts too.
  • Chapters, playback speed and downloads.
  • Optional skipping of sponsor segments (SponsorBlock).
  • Import and export your subscriptions as OPML.

Audiobooks

Lyrics

  • Synced line by line where available, with romanization for Japanese, Korean and Chinese.
  • Song credits and artist info next to the player.

Your library, and bring your own

  • Playlists, folders, pins, liked songs, followed artists and shows, all stored on your device.
  • Import playlists from a link, or from the data export of another streaming service (for example a Spotify account data export).
  • Listening stats, kept on your device.

Made for you

  • Personal mixes, a weekly discovery list and recommended songs for your playlists, worked out on your device from what you play.

Privacy

  • No account, no analytics, no telemetry, no crash reporting. More below.

Mac extras

  • Menu bar controls and a mini player.
  • Media keys, global shortcuts and a full set of keyboard shortcuts.
  • Automatic updates.

iPhone extras

  • Lock Screen, Control Center and Dynamic Island playback controls.
  • Picture in Picture for music videos and video podcasts.

How it works

Spotless gets its music catalogue from public sources, mainly YouTube Music, and plays the audio itself with mpv. There is no web player inside, so there are no audio, video or banner ads. Podcasts come straight from their publishers' feeds, audiobooks from LibriVox and the Internet Archive, and lyrics from services such as LRCLIB.

There is no Spotless server. Your library, playlists, history, mixes and downloads are built and kept on your device. If you want your existing YouTube Music likes and playlists, you can sign in with your YouTube account, and only then.

Privacy

  • No account, no analytics, no telemetry, no crash reporting. The developer runs no server and receives nothing from the app.
  • Your library, playlists, history, stats and downloads stay on your device.
  • The app talks to third-party services directly to work: YouTube for music and videos, and lyrics, podcast, audiobook and metadata services (for example LRCLIB, Apple's podcast directory, Deezer's public search, MusicBrainz, SponsorBlock, the Internet Archive). They receive what a request needs, such as a search term or a song title and artist, plus your IP address, like any website would.
  • YouTube sign-in is optional. The sign-in cookie is kept in the system Keychain and is sent only to YouTube/Google. While you are signed in, songs you play are added to your YouTube history unless you turn that off in Settings or use a private session.

The full text is on the privacy page.

Build from source

Mac

You need macOS with Xcode's command line tools, Rust (stable), Node.js 20 or later with pnpm, and libmpv from Homebrew for development.

brew install mpv
cargo install tauri-cli --locked          # or use ui/node_modules/.bin/tauri after pnpm install
(cd ui && pnpm install)
export LIBRARY_PATH="$(brew --prefix)/lib:$LIBRARY_PATH"
cargo tauri dev                           # run with hot reload
scripts/build-mac.sh --release            # a Spotless.app that uses Homebrew's libmpv

For a self-contained app and DMG that runs on other Macs, use scripts/release-mac.sh. It bundles libmpv and FFmpeg from a pinned, signature-checked IINA release, builds a universal binary by default, and signs ad hoc unless you set SIGN_IDENTITY (and NOTARY_PROFILE to notarize). See the comments at the top of the script and docs/BUILD-PLATFORMS.md.

iPhone

You need a recent Xcode, XcodeGen and the iOS Rust targets.

brew install xcodegen
rustup target add aarch64-apple-ios aarch64-apple-ios-sim
scripts/build-ios-core.sh                 # the shared core as an xcframework (--release for speed)
cd ios/Encore && xcodegen generate && open Encore.xcodeproj

In Xcode, pick your own team under Signing & Capabilities, then run the Encore scheme (the project's internal name; the app is called Spotless). Tests: SIM=<simulator udid> ios/Encore/scripts/test.sh.

Tests

export LIBRARY_PATH="$(brew --prefix)/lib:$LIBRARY_PATH"
cargo test -p limusic-app --lib
cd ui && pnpm check

More in CONTRIBUTING.md.

FAQ

Is it really free?
Yes. There is no paid tier, no subscription and nothing to unlock. Spotless is open-source software under the GPL, and it has no servers to pay for: the app runs on your device and fetches what you play directly from the source.
Why is there no account?
Because nothing needs one. Your library, playlists and history live on your device, and there is no Spotless server to sign in to. The only sign-in is the optional one to YouTube, for bringing in your existing YouTube Music library.
Is it legal?
Spotless is an independent open-source app. It does not host or redistribute any music; it plays what YouTube and the other services serve to any other client. It is not affiliated with, endorsed by or connected to Spotify, YouTube, Google or any other company whose services it talks to. Whether and how you use it is up to you, in line with the laws and terms that apply where you live.
Does it work on Windows, Linux or Android?
Not as a supported release. The Mac and iPhone apps are what we build and test. The upstream project, Limusic, has Windows and Linux builds.

Credits

Spotless is a fork of Limusic by SimoHypers and contributors (GPL-3.0), which in turn started from the playback engine of Metrolist. Thank you.

It also builds on:

Third-party licences are listed in THIRD-PARTY-NOTICES.md.

License

Spotless is free software under the GNU General Public License v3.0 or later. All product names and trademarks belong to their owners.

About

Free music, podcasts and audiobooks for Mac and iPhone. No ads, no account.

Resources

Contributing

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages