About this project

SpotX-Bash is a Bash-based patcher for the Spotify desktop client on Linux and macOS. It modifies the installed client to remove advertising and adjust certain client behaviours, and it also offers helpers for installing or rolling back client versions on supported platforms. Main capabilities described in the README: - Block all audio, banner and video ads - Block logging - Enable developer mode - Enable experimental features - Hide audiobooks, episodes and podcasts on the home screen - Block automatic updates on macOS - Install the latest desktop client versions on macOS and APT-based Linux distributions - Claimed support for all Linux distributions and OS X/macOS 10.11 and newer The README lists the latest supported client version as 1.3.0.277.g5441bb3e. Usage is via a one-line shell command that downloads and runs the script, for example `bash <(curl -sSL https://spotx-official.github.io/run.sh)`, with an alternative raw GitHub URL and a pipe form for shells without process substitution. By default, supported experimental features are enabled and free-tier patches are applied; paid Premium users are told to pass `-p` / `--premium`. macOS auto-updates are not disabled by default and can be blocked with `-B` / `--blockupdates`. Snap installations require the bundled `spotx-snap.sh` helper, which must stay in the same directory as `spotx.sh`; the repository is cloned and the helper run from there. NixOS users are directed to a separate SpotX-Nix project that applies the patch while building the Spotify package without modifying the Nix store. The README documents a set of command-line options, including: `-B` block client auto-updates (macOS), `-c` clear client app cache, `-d` enable developer mode, `-e` exclude all experimental features, `-f` force the script to run, `-h` hide non-music content on the home screen, `--help` print options, `-i` interactive mode, `--installdeb` install the latest client deb package on APT-based distributions, `--installmac` install the latest supported client on macOS, `-l` set lyrics background colour to black, `--nocolor` remove colours from output, `--noninteractive` disable interactive prompts for automation, `-o` use the old home screen UI, `-p` mark as paid Premium subscriber, `-P <path>` set the client path, `--rollback` install the previous supported client version (macOS), `-S` skip codesigning (macOS), `--stable` use with `--installdeb` for the stable branch, `--uninstall` uninstall SpotX-Bash, and `-v` print the SpotX-Bash version. Example invocations combine flags such as `-cdh`, `-i -P $HOME/Downloads/`, `-p`, `--installdeb`, and `-B --installmac`, plus a non-interactive macOS install example. The project credits amd64fox of the SpotX project. The README links to a FAQ wiki for shell compatibility, developer mode, UI variants, Premium account usage, and Snap support questions.