Adblock for the Spotify desktop client on Linux & macOS
Latest supported version: 1.3.4.258.gc60b10b0946a
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)
- If your shell does not support process substitution, use:
curl -sSL https://spotx-official.github.io/run.sh | bash
- See the FAQ for more information about shell compatibility and using options with the pipe command
- 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
Snap / Nix:
Spotify installations using Snap require the included spotx-snap.sh helper. Download the repo so spotx-snap.sh and spotx.sh remain in the same directory:
git clone https://github.com/SpotX-Official/SpotX-Bash.git
cd SpotX-Bash
bash spotx-snap.sh
Run bash spotx-snap.sh --help for additional Snap options or see the FAQ.
Nix users on x86_64 Linux or Apple Silicon macOS should use SpotX-Nix, which applies SpotX-Bash while building the Spotify package without modifying the Nix store. It supports NixOS, nix-darwin, Home Manager, and configurations with or without flakes. Intel macOS users should continue using regular SpotX-Bash.
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 |
--noninteractive | disable interactive prompts for automation |
-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
Install latest supported client version without interactive prompts (macOS)
curl -sSL https://spotx-official.github.io/run.sh | bash -s -- --noninteractive --installmac