Spotify Control Toolkit

A lightweight Spicetify extension for Spotify Desktop that helps you block songs and artists locally.

This first beta release focuses on the Song / Artist Blocker. Cleaner, podcast blocking, and hidden item history are already prepared in the settings UI, but they are not active yet.

✨ Features

• Block individual songs
• Block artists
• Auto-skip blocked songs
• Auto-skip blocked artists
• Right-click block / unblock menu for tracks
• Settings panel inside Spotify
• Import, export, reset, and save settings
• Activity log
• Placeholder sections for future Cleaner features

🚧 Current Status

v0.1.0-beta

The blocker is working and usable, but Spotify and Spicetify updates can still break DOM-based features. This release is best treated as an early public beta.

📦 Installation

1. Install Spicetify.

2. Copy spotify-control-toolkit.js into your Spicetify extensions folder:

   %APPDATA%\spicetify\Extensions
   

3. Add the extension to your Spicetify config:

   spicetify config extensions spotify-control-toolkit.js
   spicetify apply

4. Restart Spotify.

🎵 Song / Artist Blocker

You can block music in two ways:

• Right-click a track and choose Block this song or Block this artist
• Open Spotify Control Toolkit Settings from the Spotify profile menu and use the current song / artist buttons

When a blocked song or blocked artist starts playing, the extension automatically skips to the next track.

⚙️ Settings

The settings panel includes:

• Auto-skip blocked songs
• Auto-skip blocked artists
• Block currently playing song
• Block currently playing artist
• Blocked Songs list
• Blocked Artists list
• Activity Log
• Import config
• Export config
• Reset settings
• Save settings
• Cleaner placeholders

Settings are stored locally in Spotify / Spicetify local storage. No Spotify API, OAuth login, backend server, external database, tracking, or analytics are used.

🧹 Coming Soon

These sections are already visible as placeholders, but they do not modify Spotify yet:

• Cleaner
• Blocked Podcasts
• Hidden Cleaner Items
• Keyword filters
• Cleaner history

⚠️ Notes

• Blocked tracks may be audible for a very short moment before Spotify processes the skip.
• Right-click menu behavior depends on Spotify's current internal UI.
• If Spotify or Spicetify changes its layout, some features may need updates.

🔒 Privacy

Spotify Control Toolkit runs locally inside Spotify Desktop through Spicetify.

It does not use:

• Spotify API
• OAuth
• Backend servers
• External databases
• Analytics
• Tracking code

Screenshots

Screenshots

Sponsor