README.md
July 3, 2026 ยท View on GitHub
Adblock for the Spotify desktop client on Linux & macOS
Latest supported version: 1.2.93.667.g7b5cc0ce
Features:
- Block all audio, banner & video ads
- Block logging
- Enable developer mode
- Enable experimental features
- Hide audiobooks, episodes & podcasts on home screen
- Block automatic updates (macOS)
- Install latest desktop client versions on macOS and APT-based Linux distros
- Supports all Linux distros and OS X/macOS 10.11+
Usage:
- Run the following command in terminal:
bash <(curl -sSL https://spotx-official.github.io/run.sh)
or
bash <(curl -sSL https://raw.githubusercontent.com/SpotX-Official/SpotX-Bash/main/spotx.sh)
- By default...
- all supported experimental features are enabled
- free-tier user patches are applied, paid-premium users should use
-p/--premiumflag - macOS client auto-updates are NOT disabled, block auto-updates with
-B/--blockupdatesflag
- View additional flags/options and examples in the
Optionssection below - For more information, see the FAQ
Options:
Click to expand!
| Option | Description |
|---|---|
-B | block client auto-updates [macOS] |
-c | clear client app cache |
-d | enable developer mode |
-e | exclude all experimental features |
-f | force SpotX-Bash to run |
-h | hide non-music on home screen |
--help | print options |
-i | enable interactive mode |
--installdeb | install latest client deb pkg on APT-based distros [Linux] |
--installmac | install latest supported client [macOS] |
-l | set lyrics background color to black |
--nocolor | remove colors from SpotX-Bash output |
-o | use old home screen UI |
-p | paid premium-tier subscriber |
-P <path> | set path to client |
--rollback | install previous supported client version [macOS] |
-S | skip codesigning [macOS] |
--stable | use with '--installdeb' for stable branch [Linux] |
--uninstall | uninstall SpotX-Bash |
-v | print SpotX-Bash version |
Examples:
Run SpotX-Bash, clear app cache, enable dev mode, hide non-music categories
bash <(curl -sSL https://spotx-official.github.io/run.sh) -cdh
Run SpotX-Bash, enable interactive mode, set custom path to client
bash <(curl -sSL https://spotx-official.github.io/run.sh) -i -P $HOME/Downloads/
Run SpotX-Bash, set paid premium-tier subscriber
bash <(curl -sSL https://spotx-official.github.io/run.sh) -p
Run SpotX-Bash, install latest testing branch client version (Linux)
bash <(curl -sSL https://spotx-official.github.io/run.sh) --installdeb
Run SpotX-Bash, block auto-updates, install latest supported client version (macOS)
bash <(curl -sSL https://spotx-official.github.io/run.sh) -B --installmac