Catppuccin for spicetify

View on GitHub

Spicetify Theme Preview

Previews

Usage

  1. Follow the installation instructions for Spicetify

    • Note: The installation instructions for linux have you setting /opt/spotify and /opt/spotify/Apps/* permissions to 777. This is not good practice and should be avoided. If you want, you can set the group ownership for these paths to one that your user is apart of (i.e. users), or you can create a new group and add it as a secondary group to your user. After that you can use the following command to give access to the group:
      GROUP=<group_name>
      sudo chgrp $GROUP /opt/spotify
      sudo chgrp -R $GROUP /opt/spotify/Apps
      sudo chmod 775 /opt/spotify
      sudo chmod 775 -R /opt/spotify/Apps
      
  2. Follow the installation and basic usage guide to setup Spicetify

  3. Clone the repository. There are 4 flavours for this theme: mocha, macchiato, frappe and latte. All themes are present in their specific folders. Move the theme folders as well as the extensions to spicetify's config directory by running:

    cp -r catppuccin-* ~/.config/spicetify/Themes/
    cp js/* ~/.config/spicetify/Extensions/
    
  4. Set theme and color scheme. Supported color schemes: rosewater, flamingo, mauve, pink, maroon, red, peach, yellow, green, teal, blue, sky, lavender. Example: the mocha theme with lavender color scheme can be set as:

    spicetify config current_theme catppuccin-mocha
    spicetify config color_scheme lavender
    spicetify config inject_css 1 replace_colors 1 overwrite_assets 1
    spicetify config extensions catppuccin-mocha.js
    
  5. If you want to update the theme without opening it up run spicetify update. If you want to update the theme and open/restart Spotify at the same time run spicetify apply

  6. When changing the theme, remember to change the JS extension to the appropriate theme flavour. Extensions can be removed by running spicetify config extensions catppuccin-<flavour-name>.js Example: spicetify config extensions catppuccin-mocha.js. Then after changing to your new theme, enable the appropriate extension by running spicetify config extensions catppuccin-<flavour-name>.js

📜 License

Catppuccin is released under the MIT license, which grants the following permissions:

  • Commercial use
  • Distribution
  • Modification
  • Private use

For more convoluted language, see the LICENSE.

💝 Thanks to