An Ad-Blocking and Theming Patcher for the Spotify Desktop Client on Windows
Requirements • Features • Installation • Uninstall • FAQ • Contributors • Disclaimer
| Component | Minimum Version |
|---|---|
| OS | Windows 7 – 11 |
| Spotify | Official desktop client (Microsoft Store version not supported) |
| PowerShell | 5.1 or later |
- Blocks banner, video, and audio advertisements in the client, including newer ad formats (HTML display ads, in-player video ads, sponsored playlist placements)
- Optionally hides podcasts, episodes, and audiobooks from the homepage
- Optionally blocks automatic Spotify updates
- Theme customization, with a choice between the new and classic UI layouts
- Custom lyrics color schemes (28 options)
- Advanced installation options — see installation parameters
Choose the installation type that best fits your needs.
Standard Installation (New Theme)
Includes the redesigned interface (new sidebars, updated cover art) and all experimental features. Requires confirming a few prompts during setup.
Option 1 — Download and run: Install_New_theme.bat
Option 2 — Run in PowerShell:
iex "& { $(iwr -useb 'https://raw.githubusercontent.com/SpotX-Official/SpotX/refs/heads/main/run.ps1') } -new_theme"Mirror:
iex "& { $(iwr -useb 'https://spotx-official.github.io/SpotX/run.ps1') } -m -new_theme"Standard Installation (Old Theme)
Includes:
- Forced install of version
1.2.13(the old theme was removed in later releases) - Classic UI theme
- Automatic blocking of Spotify updates
- All experimental features
Option 1 — Download and run: Install_Old_theme.bat
Option 2 — Run in PowerShell:
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:
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"Full Installation (No Prompts)
A hands-off install that performs the following automatically:
- Activates the new theme (updated sidebars, cover art)
- Hides podcasts, episodes, and audiobooks from the homepage
- Applies the static lyrics theme (
spotify) - Hides ad-like sections
- Enables all experimental features
- Installs the recommended Spotify version
- Blocks future Spotify updates
- Automatically launches Spotify once installation completes
Option 1 — Download and run: Install_Auto.bat
Option 2 — Run in PowerShell:
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:
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"Other Installation Types
Premium Installation
For Premium account holders. This option skips the ad-blocking logic, which is not needed on paid accounts, and only reduces podcast audio ads.
Option 1 — Download and run: Install_Prem.bat
Option 2 — Run in PowerShell:
iex "& { $(iwr -useb 'https://raw.githubusercontent.com/SpotX-Official/SpotX/refs/heads/main/run.ps1') } -premium -new_theme"Mirror:
iex "& { $(iwr -useb 'https://spotx-official.github.io/SpotX/run.ps1') } -m -premium -new_theme"Custom Installation with Parameters
For more granular control over the install, see the full list of available flags in the parameters guide.
Option 1 — Run the uninstaller: Uninstall.bat
Option 2 — Reinstall Spotify: A clean reinstall also removes SpotX. For a complete removal, use the Uninstall-Spotify tool first.
Common questions and troubleshooting steps are covered in the SpotX FAQ.
| Platform | Link |
|---|---|
| Telegram Channel | spotify_windows_mod |
| Telegram Community | SpotxCommunity |
| macOS / Linux Version | SpotX-Bash |
| Name | Role | Web Links |
|---|---|---|
| Community | Author | Com link to GitHub |
| William | Contributor | willx.tech |
SpotX modifies the official Spotify desktop client and is provided as-is, for evaluation purposes, without warranty of any kind. Use it at your own risk, and be aware that it may conflict with Spotify's Terms of Service.