SpotX-Bash

---

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 13+ and APT-based Linux distros
• Supports all Linux distros and OS X/macOS 10.11+
• Older macOS releases require a compatible Spotify client installed manually; see the version timeline.

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 / --premium flag
  • macOS client auto-updates are NOT disabled, block auto-updates with -B / --blockupdates flag
• View additional flags/options and examples in the Options section 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:

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

Thanks:

• amd64fox of SpotX