Skip to main content

Installation for Linux and Mac

Advanced installation guide for Linux and Mac

  • By default, all supported experimental features are enabled
  • View additional arguments and examples in the Options section
  • See the FAQ for more information

Run the following command in terminal:

bash <(curl -sSL https://spotx-official.github.io/run.sh)

Options

Command line arguements for installation

OptionDescription
-Bblock Spotify auto-updates [macOS]
-cclear Spotify app cache
-denable developer mode
-eexclude all experimental features
-fforce SpotX-Bash to run
-hhide non-music on home screen
--helpprint options
-ienable interactive mode
--installdebinstall latest client deb pkg on APT-based distros [Linux]
--installmacinstall latest supported client (macOS)
-lno lyrics background color
-ouse old home screen UI
-ppaid premium-tier subscriber
-P <path>set path to Spotify
-Sskip codesigning [macOS]
--stableuse with '--installdeb' for stable branch [Linux]
--uninstalluninstall SpotX-Bash
-vprint SpotX-Bash version
-V <version>install client version [macOS]

Examples

Some of the use case 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 Spotify

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