Home › Configuration & features › Spotify Developer Mode and the Debug Window
Configuration & features

Spotify Developer Mode and the Debug Window

7 min read· Last checked: 7 October 2026
Short answer

BlockTheSpot's README describes a developer mode in Spotify: click the two dots in the top-left corner, go to Develop, and choose Show debug window to try experimental options. In config.ini, the Developer section enables the developer patch that makes this available. It is separate from ad blocking. Change one option at a time, and revert anything that behaves unexpectedly.

Current status: The official BlockTheSpot repository is archived (read-only) as of February 2026. For what this means for your install, see the live status page.

What developer mode is for

Spotify's desktop app includes a developer area that exposes a debug window and experimental options. BlockTheSpot's README describes how to reach it, and it presents the feature as a way to try options and enable or disable features in real time. It is an advanced area intended for experimentation, and it is not required for ad blocking. Most people never need it.

This page explains what the README says, what the config file shows, and how to use the area cautiously. We do not guarantee that any particular option will behave in a particular way, because the project does not document each one in the sources we reviewed.

How to open the debug window

  1. Open the Spotify desktop app with BlockTheSpot installed, if you have it.
  2. Click the two dots in the top-left corner of the window.
  3. Go to Develop, then choose Show debug window.

The README gives these steps directly. Menu wording can change between Spotify releases, so if the names differ on your build, look for a developer or debug option in the same area. If you cannot find it, the feature may be unavailable on your build, which is worth knowing.

What the Developer section in config.ini does

The config.ini file has a section named Developer with Enable=1. The file's own comment labels it the developer patch. It contains a signature, a value, and an offset, which together describe a byte-level edit to Spotify's code. The config does not spell out the effect, but the section's purpose, read alongside the README, is to make the developer area described above available. It is not one of the sections that controls ad blocking, so changing it will not turn audio or banner ads on or off.

Because the section is a signature-based edit, it depends on the exact build of Spotify. A mismatch may stop the developer area from appearing, and it does not affect the ad-blocking sections in the same way. Our config.ini guide explains each section and how the Enable flags work.

What the experimental options are

The README says you can play around with the options in the debug window and enable or disable features in real time. The project does not list every option in the sources we reviewed, so we cannot give you a complete catalogue. Some options may affect how the interface looks or behaves. Others may affect features that Spotify itself is still testing. Treat them as experiments, not as settings with documented effects.

A cautious way to experiment

Why developer mode can cause confusion

Because the developer area changes what you see, it is easy to mistake an experimental option for a broken patch, or the reverse. If ads come back after you changed a developer option, that is worth checking against the ad-blocking sections in config.ini, which are the ones that control ad removal. Keeping the two areas separate in your head makes troubleshooting much easier.

When to turn it off

If you do not use the developer area, leave it alone. Every extra change is one more thing that could interact with a future Spotify update. If you have been experimenting and something is no longer stable, go back to the original files, using our uninstall guide, and reapply only the parts you still want.

Summary

Developer mode in BlockTheSpot opens a debug window and experimental options through the Develop menu, enabled by the Developer section of config.ini. It is separate from ad blocking and not required for it. Use it carefully, one change at a time, with a backup in place.

Troubleshooting the developer area

If the Develop menu or the debug window does not appear, start with the simplest checks. Confirm the BlockTheSpot files are in place and the config.ini is current. Confirm your Spotify version matches the config header. Restart Spotify after any change. If the menu still does not appear, the Developer section may not match your build, which is the same signature issue that affects other sections.

Recording what you change in the debug window

Because the debug window lets you try options in real time, it is easy to forget what you changed. Keep a short log: the option name, the date, and the result. That log makes it easy to revert, and it helps if you later need to report a problem.

Keeping a safe starting point

Before you open the debug window or try an option, keep a copy of your current config.ini and the original Spotify files. The developer section is one of several sections in the file, and changing the wrong line can make the patch behave unexpectedly. A copy gives you a known state to return to, and it takes less than a minute to make.

Read the Developer section of config.ini before you enable anything. It contains Enable=1, a signature, a value, and an offset. Leave those values as they are unless you have a specific reason and a backup. If you find yourself editing them, stop and read the config.ini guide first.

Who this is useful for

Developer mode is most useful to people who want to see how Spotify's interface is built, or who want to try experimental options in a controlled way. It is not useful for removing ads, and most listeners will never need it. If you are not sure whether you want it, leave it alone. The rest of the patch works without it.

Where to go next

The developer section is one part of the file described in the config.ini guide. If something stops working after you change an option, restore your backup using the uninstall guide, or follow the troubleshooting hub to find the cause.

Frequently asked questions

How do I open the Spotify debug window?

The official README says to click the two dots in the top-left corner of Spotify, go to Develop, then choose Show debug window. Menu names can change between Spotify releases, so look for a developer or debug option if the wording differs.

Is developer mode the ad-blocking part of BlockTheSpot?

No. In config.ini, the Developer section enables a developer patch that makes the developer tools available. The ad-blocking behaviour is controlled by other sections, such as the URL block list and the xpui-snapshot.js patches.

Is it safe to change experimental options?

Treat them with care. The README suggests trying options in real time, but an experimental option can change behaviour in ways the project does not describe. Change one at a time, note what you changed, and revert if something behaves oddly.