Spotless support
Help for Spotless on Mac and iPhone. Last updated November 17, 2026.
Report a problem or ask a question
Open an issue on GitHub: github.com/fjenn/spotless/issues. A free GitHub account is enough. Please include:
- what you did, and what happened instead;
- Mac or iPhone, and the Spotless version (Settings, then About);
- a screenshot, if something looks wrong.
On the Mac, Settings, then About can copy your system details for the report. They contain no account data, but check them before you paste. Before opening a new issue, search the existing ones: someone may have reported it already.
Common fixes
- A song won't play, or playback stops. Sources change from time to time. Make sure you have the latest version: the Mac app updates itself, and you can check under Settings, then About. If it persists, try again a little later and report it.
- "Spotless can't be opened" on the Mac. Download the DMG only from this site or the official releases page, and move the app to Applications before opening it.
- No lyrics for a song. Not every song has lyrics in the public lyrics services. You can search for them by hand from the lyrics view.
- Your library after reinstalling. Your library lives on your device, so deleting the app deletes it. If you were signed in to YouTube, your YouTube library comes back when you sign in again.
Downloads
Spotless for Mac (Apple Silicon and Intel, macOS 13.3 or later) is on opena.tech/spotless and on the releases page. iPhone is coming soon on TestFlight, then the App Store.
Privacy
Spotless collects no data. See the privacy policy.
Contributing
Spotless is free software under the GPL-3.0. The source is on GitHub, and bug fixes and ideas are welcome.