SpotX README

The project's README from github.com/SpotX-Official/SpotX. As one markdown file: README.md.

Patcher for Spotify Desktop Client on Windows

• Requirements • Features • Installation • Uninstall • FAQ • Disclaimer

Requirements

Features

Installation / Update

Choose installation type:

Usual installation (New theme)

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

Just download and run Install_New_theme.bat

or

Run The following command 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"
Usual installation (Old theme)

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

Just download and run Install_Old_theme.bat

or

Run The following command 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

Full installation without confirmation, what does it do?

  • New theme activated (new right and left sidebar, some cover change)
  • Hiding podcasts/episodes/audiobooks from the homepage
  • Activated static theme spotify 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.

Just download and run Install_Auto.bat

or

Run The following command 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 types of installations

Installation for premium

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

Just download and run Install_Prem.bat

or

Run The following command 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"
Installing with parameters

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

Uninstall

or

FAQ

Read FAQ

Disclaimer

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

SpotX (SpotX-Official/SpotX)

Searching Database…

22.7K ·GitHub
这是干什么的?SpotX 是 Windows 上官方 Spotify 桌面客户端的补丁工具:它可以屏蔽横幅、视频和音频广告,并修改一些客户端的隐藏功能。它以一组安装脚本的形式提供,只需运行一次。
我怎么用它给我的 Spotify 客户端打补丁?下载发布包并运行其中一个 .bat 安装脚本,比如 InstallNewtheme.bat,或者粘贴 README 里的 PowerShell 命令。脚本会给你现有的客户端打补丁,并在过程中让你确认几个操作。
运行之前我需要装好什么?Windows 7 到 11、官方桌面版 Spotify(Microsoft Store 版本不行),以及 PowerShell 5.1 或更新版本。
我的 Spotify 是从 Microsoft Store 装的——能用吗?不行,SpotX 只支持官方桌面客户端。完整自动安装时,如果检测到 Microsoft Store 版的 Spotify,甚至会把它卸载,并在你当前客户端的基础上安装推荐版本。
它对遥测数据做了什么?作为补丁的一部分,Spotify 客户端里的分析数据上报会被禁用。
用它有什么要注意的吗?这个仓库采用 MIT 许可证,但 README 的免责声明指出 SpotX 会修改官方 Spotify 客户端,并以评估版本的形式提供,所以使用风险自负。
四种安装模式有什么区别?New theme 是默认安装,带有刷新后的侧边栏界面;old theme 恢复经典外观,但强制使用 Spotify 1.2.13,因为那个界面在后续版本中已被移除。full install 全程无需确认运行,还会隐藏播客并阻止更新;premium install 则跳过广告屏蔽,适合付费账户。
除了广告消失,还有别的变化吗?它可以选择在首页隐藏播客、单集和有声书,启用所有实验性功能,并禁用分析数据上报。新主题本身还会改变左右两侧的侧边栏以及部分封面图。
我怎么撤销这个补丁?运行 Uninstall.bat,或者重新安装 Spotify——README 建议彻底卸载 Spotify 以实现干净的移除。
Size
24.9 MB
Stars
22.7K
Age
5y
Commits · 90 Days