SpotX-Official/SpotX-Bash

SpotX Mac and Linux adblocker for the Spotify desktop client, in Bash

Shell

6,239

292 commits

updated Oct 8, 2026

See the code

README

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)

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:

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

Thanks:

amd64fox of SpotX

adblock

adblocker

linux

mac

macos

spotify

spotify-adblock

spotify-ad-blocker

spotify-adblocker

spotify-ad-free

spotify-ads

spotify-linux

spotify-mac

spotify-no-ads

spotify-no-update

spotx

Significant stargazers

injust

41 followers · starred Apr 2024

Eliver L.

1,169 followers · starred Apr 2024

huihui

178 followers · starred Jul 2025

Calvin Bui

82 followers · starred Oct 2023

Similar repos

SpotX-Official/SpotX

SpotX patcher used for patching the desktop version of Spotify

22,719

same org

Nuzair46/BlockTheSpot-Mac

Spotify Ad blocker for MacOS

1,505

mrpond/BlockTheSpot

Video, audio & banner adblock/skip for Spotify

12,435

abba23/spotify-adblock

Adblocker for Spotify

2,246

artemgordinskiy/Spotifree

An OS X app that automatically mutes ads on Spotify [DISCONTINUED]

1,048

theRealPadster/spicetify-hide-podcasts

Spicetify extension to hide podcasts

257

dubeyKartikay/lazyspotify

Terminal Spotify client for macOS and Linux

446

aome510/spotify-player

A Spotify player in the terminal with full feature parity

7,273