Skip to content

Latest commit

 

History

History
107 lines (68 loc) · 4.03 KB

README.MD

File metadata and controls

107 lines (68 loc) · 4.03 KB

Spotify AdBlocker (SpotifyAB)

🎵 Welcome to the Spotify AdBlocker (SpotifyAB) repository by An0n-00, designed to block ads and trackers directly within the Spotify desktop app for Windows. 🚫📺

Overview

This project utilizes JavaScript injection into the Spotify application to block ads and trackers, providing an uninterrupted listening experience without intrusive interruptions. 🎧🔇

Anouncement

We are happy to announce that we have released a client app that automates the installation process. You can download the client app from the latest release in this repository. 🚀

Installation Guide

To install the Spotify AdBlocker, follow these steps:

  1. Download the Client App:

    • Obtain the SpotifyAB-Installer.exe file from the latest release
    • Run the installer to install the Spotify AdBlocker.
    • Choose the option that you want to do.

  2. Restart Spotify: Done! You have successfully installed the Spotify AdBlocker! 🎉

Visuals

Here you have some images of the client app: Visual of the Client app

Manual Installation Guide

To implement the Spotify AdBlocker, follow these steps:

  1. Download the Required File:

    • Obtain the xpui.spa file from the latest release in this repository.

  2. Replace the Existing File in Spotify Directory:

    • Navigate to your Spotify installation directory: C:\Users\_username_\AppData\Roaming\Spotify\Apps\
    • Replace the existing xpui.spa file with the downloaded xpui.spa from step 1.
    • If you encounter issues, unzip the xpui.spa to .\xpui\
    • Newly you have to have the xpui.spa and \xpui as a folder. (you can unzip the xpui.spa file with any other software that unzips .tar files)

Important

Please always read the newest release, as it may contain newer information than written here

  1. Restart Spotify:
    • Close and reopen the Spotify desktop app to apply the changes.

You have successfully installed the Spotify AdBlocker! 🎉

Caution

Compatibility Notice:

This method is specifically designed for the Spotify desktop app on Windows. The Microsoft Store version is not supported. 🖥️❌

Verification Process

You can verify the functionality by examining the contents of the xpui.spa file:

  • Unzip the xpui.spa file using any zip program.
  • Explore the extracted files. The main file of interest is ./spotifyAB/AB.js and the index.html file, which calls the JS file.
  • The AB.js file contains the JavaScript code that blocks the ads.

🌟 How to Build the Client App

If you want to build the client app yourself, follow these steps:

  1. Clone the Repository:

    git clone https://github.com/An0n-00/SpotifyAB.git
cd SpotifyAB/SpotifyABClient

  2. Build the App:

    dotnet build --Configuration Release
cd ./bin

  3. Test Your Build:

    • Run the built SpotifyAB.exe and verify its functionality.

🎉 You’ve successfully built the SpotifyAB client app!

Legal Information

  • License: This project is licensed under the MIT License. 📜
  • Disclaimer: Use this software at your own risk. No warranties are provided. ⚠️

Useful Information

Tip

I've published another project called Spotify-ad-hosts that used to block Spotify ads by modifying the hosts file. It did not work out properly due to Spotify's changes in the ad-serving mechanism. However, I recommend to add the domains to the hosts file as an additional layer of protection and to block trackers. 📝 Check it out! 📦

If you have any questions or encounter issues, please feel free to reach out by opening an issue on the GitHub repository. 📢

Enjoy your ad-free Spotify experience with SpotifyAB! 🎶🚀