Getting Started

Spicetify is a multiplatform command-line tool to customize the official Spotify client.

Installation

Windows

This is the installation method what we recommend for most users. It is the fastest and most reliable way to install Spicetify. It also includes the Spicetify Marketplace that gives you access to a tab in Spotify's sidebar that allows you to search for and install themes, extensions, and snippets.

Powershell (pre-built binary)

iwr -useb https://raw.githubusercontent.com/spicetify/spicetify-cli/master/install.ps1 | iex
iwr -useb https://raw.githubusercontent.com/spicetify/spicetify-marketplace/main/resources/install.ps1 | iex

Linux and MacOS

Shell (pre-built binary)

curl -fsSL https://raw.githubusercontent.com/spicetify/spicetify-cli/master/install.sh | sh
curl -fsSL https://raw.githubusercontent.com/spicetify/spicetify-marketplace/main/resources/install.sh | sh

---

Basic Usage

After installing Spicetify and Spicetify's Marketplace, you can use it to customize your Spotify client using all the available extensions and themes found in the Marketplace.

Updating

Spotify, every now and then, updates its client. Since we have no power over this process, you will likely need to re-apply Spicetify.

However, the update might have major changes to the client, which means you will need to run spicetify upgrade every time you update Spotify. If no update for Spicetify is available, it means that it either still works by simply running spicetify backup apply, or that we are still working on updating Spicetify to work on the new version.

After running spicetify upgrade, you will be prompted to run spicetify restore backup apply to have everything back where it was.