Customize Spotify with Spicetify

Install Homebrew

If you do not have Homebrew on your machine, follow the steps below to install it:

1. Install the command line tools for Xcode. Skip this if you already have Xcode.
   Run the script below in your macOS Terminal. Alternatively, you can Install Xcode from Mac AppStore if you prefer.
   
   xcode-select --install


2. Install Homebrew.
   Run the script below in your Terminal.
   
   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

   See Installation - Homebrew for other installation options.
   
   Note: For users based in China, if you are having issues installing Homebrew by following the above instructions, try the steps listed in this post (in Chinese) on Zhihu.

Install Spicetify

Run the script below in your Terminal to install Spicetify.

brew install khanhas/tap/spicetify-cli

Install Spicetify Marketplace

1. Download the latest release from GitHub. The asset’s name is ‘spicetify-marketplace.zip’.

2. Extract the zip file, and you will get the resulting folder ‘spicetify-marketplace-dist’.

3. Move the resulting folder to your Spicetify CustomApps folder and rename it as ‘marketplace’. The path for the Spicetify CustomApps folder is

   ~/.config/spicetify/CustomApps/ or $SPICETIFY_CONFIG/CustomApps/

   Note: If you having issues finding the Spicetify CustomApps folder, try the steps below:
   

   1. Run the below command to go to the Spicetify Config directory.

      spicetify config-dir

   2. In the Config directory, open the folder CustomApps.

4. Apply one theme first to ensure the Marketplace can install themes correctly. To do so, follow the steps below:

   1. Go to the ‘Themes’ folder in the Spicetify Config directory. In the ‘Themes’ directory, create a new folder and name it as ‘marketplace’.

   2. Download the color scheme file and save it in the ‘marketplace’ folder.

   3. Run the below commands in your Terminal to apply the ‘martketplace’ theme.

      spicetify config inject_css 1
spicetify config replace_colors 1
spicetify config current_theme marketplace

   Note: You can also manually edit the color scheme file and change the current theme using the command spicetify config current_theme marketplace. See details in Change themes manually.

5. After you put the ‘marketplace’ folder in the CustomApps directory and applied one theme, run the below command to enable Spicetify Marketplace:

   spicetify config custom_apps marketplace
spicetify apply

   You will see Marketplace appear in the left-hand sidebar in Spotify Client. Below is an example:

After you install Spicetify, run spicetify upgrade in the Terminal to ensure your Spicetify is the latest version. To access the complete Spicetify command list, run spicetify -h.

Change the themes with the command line

1. Run the below command to change your theme. Replace THEME_NAME with the desired theme’s name. For example, to change the theme to ‘Flow’, run spicetify config current_theme Flow

   spicetify config current_theme THEME_NAME

2. If the theme you want to use has multiple color schemes, run the below command to switch your theme between different colors. Replace SCHEME_NAME with the desired color.
   For example, if you are using the theme ‘Flow’, you can change the theme color to ‘violet’ with spicetify config color_scheme violet

   spicetify config color_scheme SCHEME_NAME

3. Run the below command to apply the theme to your Spotify client.

   spicetify apply

Change themes manually

Instead of changing the value of current_theme and color_scheme , and then change the themes with the command line, you can do the same by editing the config-xpui.ini file by following the steps below:

1. Run spicetify config-dir to go to the Spicetify Config directory.
2. Open the config-xpui.ini file with the TextEdit application on your Mac. Alternatively, you can open the file with Visual Studio Code or any other editors if you have them installed.
3. Change the value of current_theme and color_scheme.
4. Save the config-xpui.ini file.
5. Run spicetify apply in your Terminal to apply the theme.