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