SpotX

SpotX patcher used for patching the desktop version of Spotify

21,985 stars PowerShell Markdown Skills API Spec #adblock#spotify#spotify-ad-blocker#spotify-ad-free
AI Prompts & Specs

Repository: SpotX-Official/SpotX


Stars: 20553

README.md

<p align="center">
<a href="https://github.com/SpotX-Official/SpotX/releases"><img src="https://spotx-official.github.io/images/logos/logo.png" /></a>
</p>

<p align="center">
<a href="https://t.me/spotify_windows_mod"><img src="https://spotx-official.github.io/images/shields/SpotX_Channel.svg"></a>
<a href="https://t.me/SpotxCommunity"><img src="https://spotx-official.github.io/images/shields/SpotX_Community.svg"></a>
<a href="https://github.com/SpotX-Official/SpotX-Bash"><img src="https://spotx-official.github.io/images/shields/SpotX_for_Mac&Linux.svg"></a>
<a href="https://telegra.ph/SpotX-FAQ-09-19"><img src="https://spotx-official.github.io/images/shields/faq.svg"></a>
</p>

<h2>
<div align="center">
<b>Patcher for Spotify Desktop Client on Windows </b>
</div>
</h2>

<p align="center"> •
<a href="#requirements">Requirements</a> •
<a href="#features">Features</a> •
<a href="#installation--update">Installation</a> •
<a href="#uninstall">Uninstall</a> •
<a href="#faq">FAQ</a> •
<a href="#disclaimer">Disclaimer</a>
</p>

<h1 id="requirements">Requirements</h1>

- OS: Windows 7-11
- Spotify: Official desktop version (Microsoft Store version is not suitable)
- PowerShell: 5.1 and above

<h1 id="features">Features</h1>

- Blocks all banner, video, and audio ads in the client
- Hiding podcasts, episodes, and audiobooks from the homepage (optional)
- Block Spotify automatic updates (optional)
- Some native experimental features have been changed
- Analytics sending has been disabled
- Advanced installation parameters

<h1 id="installation--update">Installation / Update</h1>
<h3>Choose installation type:</h3>
<details>
<summary><small>Usual installation (New theme)</small></summary><p>

#### During installation, you need to confirm some actions, also contains:

- New theme activated (new right and left sidebar, some cover change)
- All experimental features included

<h4> </h4>

#### Just download and run Install_New_theme.bat

or

#### Run The following command in PowerShell:

ps1
iex "& { $(iwr -useb 'https://raw.githubusercontent.com/SpotX-Official/SpotX/refs/heads/main/run.ps1') } -new_theme"

#### mirror

ps1
iex "& { $(iwr -useb 'https://spotx-official.github.io/SpotX/run.ps1') } -m -new_theme"

</details>

<details>
<summary><small>Usual installation (Old theme)</small></summary><p>

#### During installation, you need to confirm some actions, also contains:
- Forced installation of version 1.2.13 (since the old theme was removed in subsequent versions)
- Old theme activated
- Automatic blocking of Spotify updates
- All experimental features included

<h4> </h4>

#### Just download and run Install_Old_theme.bat

or

#### Run The following command in PowerShell:

ps1
iex "& { $(iwr -useb 'https://raw.githubusercontent.com/SpotX-Official/SpotX/refs/heads/main/run.ps1') } -v 1.2.13.661.ga588f749 -confirm_spoti_recomended_over -block_update_on"

#### mirror

ps1
iex "& { $(iwr -useb 'https://spotx-official.github.io/SpotX/run.ps1') } -m -v 1.2.13.661.ga588f749 -confirm_spoti_recomended_over -block_update_on"

</details>

<details>
<summary><small>Full installation</small></summary><p>

<h4>Full installation without confirmation, what does it do?</h4>

- New theme activated (new right and left sidebar, some cover change)
- Hiding podcasts/episodes/audiobooks from the homepage
- Activated static theme <kbd>spotify</kbd> for lyrics
- Hiding ad-like sections
- All experimental features included
- Removal of Spotify MS if it was found
- Installation of the recommended version of Spotify (if another client has already been found, it will be installed over)
- Blocking of Spotify updates
- After the installation is completed, the client will autorun.

<h4> </h4>

#### Just download and run Install_Auto.bat

or

#### Run The following command in PowerShell:

ps1
iex "& { $(iwr -useb 'https://raw.githubusercontent.com/SpotX-Official/SpotX/refs/heads/main/run.ps1') } -confirm_uninstall_ms_spoti -confirm_spoti_recomended_over -podcasts_off -block_update_on -start_spoti -new_theme -adsections_off -lyrics_stat spotify"

#### mirror

ps1
iex "& { $(iwr -useb 'https://spotx-official.github.io/SpotX/run.ps1') } -m -confirm_uninstall_ms_spoti -confirm_spoti_recomended_over -podcasts_off -block_update_on -start_spoti -new_theme -adsections_off -lyrics_stat spotify"

</details>

<details>
<summary><small>Other types of installations</summary><p>

<details>
<summary><small>Installation for premium</small></summary><p>

#### Usual installation only without ad blocking, for those who have a premium account, also contains:

- New theme activated (new right and left sidebar, some cover change)
- Disabled only audio ads in podcasts
- All experimental features included

<h4> </h4>

#### Just download and run Install_Prem.bat

or

#### Run The following command in PowerShell:

ps1
iex "& { $(iwr -useb 'https://raw.githubusercontent.com/SpotX-Official/SpotX/refs/heads/main/run.ps1') } -premium -new_theme"

#### mirror

ps1
iex "& { $(iwr -useb 'https://spotx-official.github.io/SpotX/run.ps1') } -m -premium -new_theme"

</details>

<details>
<summary><small>Installing with parameters</small></summary><p>

You can specify various parameters for a more flexible installation, more details here

</details>

</details>

<h1 id="uninstall">Uninstall</h1>

- Just run Uninstall.bat

or

- Reinstall Spotify (Full uninstall Spotify recommended)

<h1 id="faq">FAQ</h1>

Read FAQ

<h1 id="disclaimer">Disclaimer</h1>

SpotX is a tool that modifies the official Spotify client, provided as an evaluation version — use it at your own risk.