Home Page
Now Playing
Artist Page
Album Page
Warning
Spotify uses dynamic class names - the userstyle may break after updates. In that case, you can check the Class Dictionary or head down to the Contributing & Bug Reports section to help patch it or report the issue.
Step-by-Step Installation Instructions
-
Install a Userstyle Manager - Before installing the theme, you need a browser extension that handles custom userstyles. The recommended choice is Stylus (available for Chrome, Firefox, Edge, and Opera).
-
Install Clean Spotify - Click the button below to open the installation page and apply the userstyle to your Spotify Web Player:
-
Verify Setup - Once installed, open or refresh the Spotify Web Player. The interface will automatically update to the clean, distraction-free layout.
Global UI & Profile Menu
- Hides global filter pills, scrollbars, and the main footer
- Cleans up the profile dropdown (hides Premium upgrade, dividers, and updates)
- Ensures essential liking/action buttons remain completely visible
Home Page
- Hides carousel-style recommendations
- Removes video reels and component shelves
- Keeps functional text buttons cleanly visible
Artist & Media Pages
- Keeps the clean Discography visible (along with the "Show All" button)
- Hides "On Tour", "About", and extra promotional shelves on Artist pages
- Removes cluttered card and list-style recommendations on Album, Playlist, and Track pages
Because Spotify updates its web layout frequently, classes will eventually break. If you notice something looks off:
- Know how to fix it? Check the Class Dictionary to locate the broken selector, swap in Spotify's new class hash, and open a Pull Request!
- Just want to report it? Open a detailed ticket in the Issues Tab with a screenshot so someone can patch it.
Making it worse before it gets better.