Spice Up Your Spotify Experience With Spicetify on Ubuntu

The open source tool that lets you use extensions and themes in the Spotify app on Linux.
Warp Terminal

If you are a regular user of Spotify, you can customize the look, feel and behavior of Spotify application on Linux.

The open source project Spicetify lets you add a 'marketplace' feature to your Spotify app from where you can install extensions and themes.

For example, you can autoskip videos, hide podcasts entirely, compare playlists and much more. With themes, you can have a different looking interface.

It is primarily a CLI tool but apart from installation and activation, you don't really have to do much in CLI. You can enjoy the extensions directly from Spotify app.

In this tutorial, I'll show the steps for installing Spotify on Ubuntu and Debian-based distributions.

πŸ“‹
Please refer to Spicetify documentation for installation instructions for other Linux distributions and Fltapaks.

Installing Spicetify on Ubuntu

The entire Spicetify installation comprises of:

  • Ensuring Spotify deb version installation
  • Giving correct permission on Spotify folders
  • Using a script to install Spicetify

Let's see the steps in detail.

Step 0: Remove Snap version of Spotify and get the debian version

Spicetify does not work with the Snap application. Check if you have snap version of Spotify installed on your Ubuntu system with:

snap list | grep spotify

If you don't see any output, you are good.

Else, remove the Snap version of Spotify with:

sudo snap remove spotify

After that, install the deb version of Spotify on Ubuntu. Ensure that you have curl installed:

sudo apt install curl

And then get the repository key and add it to your system:

curl -sS https://download.spotify.com/debian/pubkey_6224F9941A8AA6D1.gpg | sudo gpg --dearmor --yes -o /etc/apt/trusted.gpg.d/spotify.gpg

Next, add the Spotify repository details. This way, you'll be getting the Spotify package as well as future updates on it along with regular system updates.

echo "deb http://repository.spotify.com stable non-free" | sudo tee /etc/apt/sources.list.d/spotify.list

And now, install Spotify:

sudo apt-get update && sudo apt-get install spotify-client

Step 1: Prepare for installation

Since Spicetify adds extensions and themes, it needs to access the directories where Spotify files are stored. Spicetify documentation recommends changing permissions for those directories.

Do that by running these two commands one by one:

sudo chmod a+wr /usr/share/spotify
sudo chmod a+wr /usr/share/spotify/Apps -R

Next, run the Spotify app and make sure that you are logged in.

If you don't do that, you'll see the "Could not detect "prefs" file location" error later on.

error Could not detect "prefs" file location.
success Default config-xpui.ini generated.
error Cannot detect Spotify "prefs" file location. Please manually set "prefs_path" in config-xpui.ini

Step 2: Start Spicetify installation

βœ‹
Again, ensure that you have Spotfiy app running and you are logged into it.

Now, all you have to do is fetch the official installation script and run it:

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

It starts downloading the file and running it. At one point, it will ask if you want to install spicetify marketplace. Press enter to confirm it.

Installing Spicetify on Ubuntu

Press enter to install spicetify marketplace and the process continues.

Install Spicetify on Ubuntu

At the end of the entire thing, you'll see an "error message" that "You haven't backed up. Run "spicetify backup apply".

It's not really an error and you should not just run 'backup apply' immediately. If you try to do that, it will show an error that "spicetify command not found". That's because spicetify is only recognized after the terminal session starts.

That's okay. We handle it in the next step.

Step 3: Finishing up the installation

🚧
Restart your terminal.

Once you have restarted the terminal, run the following command:

spicetify backup apply

After this, Spotify restarts automatically. You can now see the marketplace option on the Spotify interface.

Click on it and you shall see the option to install extensions, themes, snippets etc. Hover over an item and you'll see the "install button".

Spiectify adds a marketplace from where you can install extensions, themes and more

When you click the install button, it is installed immediately and you'll be asked to reload Spotify:

Reload Spotify after installing an extension from Spicetify

Congratulations! You can start enjoying Spicetify and customize your Spotify experience now.

Few tips on using the Spicetify marketplace

Let me share a few tips from my Spicetify experience that should also help you.

Choose your extensions wisely

By default, the extensions are displayed based on number of stars they have. This is already a good thing as it indicates that the extension should work properly.

Not all extensions will work flawlessly, some might impact the Spotify app performance and user experience. For example, I installed a theme and it changed the interface and header menu was gone and I could not even access the market place or any other option. It can be reset which I discuss in later section.

You should use extensions that have been recently updated and have good number of stars.

Don't install too many extensions unnecessarily. Remove the ones you don't need.

Remove unncessary Spicetify extensions from Spotify

Theme it right, theme it once

Only one theme can be installed and used at a time. And as soon as you install a theme, the previous one is no longer in installed state. Some themes have several color variants, though.

Messed it up? Restore it

It is not impossible to mess things up. The good thing is that you can restore the default Spotify looks with:

spicetify restore

If you want to reuse Spiectify, apply it again:

spicetify apply

Update Spicetify

It is a good idea to keep Spiectify updated, especially when you are updating Spotify. You can do this with:

spicetify update
spicetify upgrade

Removing Spicetify

To uninstall Spicetify, you should first restore the default looks:

spicetify restore

And then remove the Spicetify files:

rm -rf ~/.spicetify
rm -rf ~/.config/spicetify

Conclusion

Spicetify is something good to have if you want greater control over your music experience. Don't like songs with vulgar lyrics, block them all with an extension. Hate an artist, block them from any automated playlist.

Compatibility can always be a concern and the restore feature helps a great deal.

As far as the security concern, I cannot give a 100% yes or no. Spicetify is open source and so are all the extensions and themes. Of course, it is not possible to have a security check on all of them all the time.

Spicetify is installed without sudo permission and it has limited permission with read-write permissions to Spotify folders only. In theory, it should not impact anything other than Spotify on your system.

Also, Spicetify works on client-side. Meaning, everything happens on your computer, not in your Spotify account. If you install Spotify on any other device, Spiectify changes won't be there.

About the author
Abhishek Prakash

Abhishek Prakash

Created It's FOSS 11 years ago to share my Linux adventures. Have a Master's degree in Engineering and years of IT industry experience. Huge fan of Agatha Christie detective mysteries πŸ•΅οΈβ€β™‚οΈ

Become a Better Linux User

With the FOSS Weekly Newsletter, you learn useful Linux tips, discover applications, explore new distros and stay updated with the latest from Linux world

itsfoss happy penguin

Great! You’ve successfully signed up.

Welcome back! You've successfully signed in.

You've successfully subscribed to It's FOSS.

Success! Check your email for magic link to sign-in.

Success! Your billing info has been updated.

Your billing was not updated.