Skip to main content



iwr -useb | iex


Follow this guide:


scoop install spicetify-cli

Spotify installed from Scoop

  • To find the location of your Spotify installation, run scoop prefix spotify.
$ scoop prefix spotify

After you have located it, set spotify_path to that directory in Spicetify's config file:



winget install Spicetify.Spicetify

Linux and MacOS

curl -fsSL | sh

Homebrew or LinuxBrew

brew install spicetify/homebrew-tap/spicetify-cli

On macOS, you will need to setspotify_path to /Applications/ in the ~/.config/spicetify/config-xpui.ini config file.


yay -S spicetify-cli

Note for Linux users

Spotify installed from AUR

Before applying Spicetify, you need to gain write permission on Spotify files, by running command:

sudo chmod a+wr /opt/spotify
sudo chmod a+wr /opt/spotify/Apps -R

Note: Your Spotify client location might be different.

Spotify installed from Snap

Apps installed from Snap cannot be modified so you need to follow these steps to get Spicetify working:

  1. Uninstall Spotify in Snap or run command snap remove spotify
  2. Install Spotify using apt:
curl -sS  | sudo apt-key add -
echo "deb stable non-free" | sudo tee /etc/apt/sources.list.d/spotify.list
sudo apt-get update && sudo apt-get install spotify-client
  1. After Spotify is installed successfully, you need to gain read write permissions on Spotify files, by running commands:
sudo chmod a+wr /usr/share/spotify
sudo chmod a+wr /usr/share/spotify/Apps -R

Note: Your Spotify client location might be different.

Spotify installed from Flatpak

  • You need to find where Flatpak stores your Spotify client. In Manjaro, it is stored in:
  • Yours might be different, try these steps:
  1. Find flatpak installation place with command: flatpak --installations
  2. Go to that directory and dig in until you find folder which contain items like these:


After you have Spotify location, set spotify_path in config file to that directory:


  1. Find your prefs file: It could be either in these two locations:
  • ~/.config/spotify/prefs
  • ~/.var/app/com.spotify.Client/config/spotify/prefs

Check both, expand the right one to absolute path and set it to prefs_path in config file.

spicetify config prefs_path ~/.var/app/com.spotify.Client/config/spotify/prefs
  1. Finally in terminal, set read/write permission for it:
sudo chmod a+wr /var/lib/flatpak/app/com.spotify.Client/x86_64/stable/active/files/extra/share/spotify
sudo chmod a+wr -R /var/lib/flatpak/app/com.spotify.Client/x86_64/stable/active/files/extra/share/spotify/Apps

Legacy Installations

If, for some reason, you are not using the most up to date Spotify client, you may need to install a specific version of Spicetify. This is not recommended as our prime focus will always be the latest Spotify version.

As such, you will need to run either of the below commands with the desired version. If you wish to use old Spotify client v1.1.56 or older, you have to install spicetify v1.2.1.

Windows: In powershell

$v="1.2.1"; Invoke-WebRequest -UseBasicParsing "" | Invoke-Expression

Linux/MacOS: In bash

curl -fsSL -o /tmp/
sh /tmp/ 1.2.1

spicetify v1 code is available in branch legacy if you want to build from source.

If you want legacy themes, you can find them here.