Skip to content


khanhas edited this page May 27, 2019 · 2 revisions


Config file is located at:
Windows: %userprofile%\.spicetify\config.ini
Linux: $XDG_CONFIG_HOME/.config/spicetify/config.ini or ~/.config/spicetify/config.ini
MacOS: ~/spicetify_data/config.ini

Or simply run

spicetify -c

to know where it is.

For detail information of each config field, please run:

spicetify --help config


There are 2 places you can put your themes:

  1. Themes folder in Home directory

Windows: %userprofile%\.spicetify\Themes\
Linux: $XDG_CONFIG_HOME/.config/spicetify/Themes/ or ~/.config/spicetify/Themes
MacOS: ~/spicetify_data/Themes

  1. Themes folder in Spicetify executable directory

If there are 2 themes having same name, theme in Home directory is prioritized.

Every theme should contain:

  • color.ini: store colors value that later will be converted to CSS variables
  • user.css: set of custom CSS rules to manipulate, hide, move UI elements.

Color value can be in several formats and forms:

  • Hex: e.g #FF0000, #1258F6, #F55

  • Decimal: e.g 255,255,255, 50,80,120

  • Environment variables can be used in place of color.

    • Syntax: ${<variable name>}
    • Example usage: main_fg = ${LIGHT_GREY}
  • [Linux] You can use XResources variable in place of color. Extremely useful for who uses pywal to generate color scheme.

    • Syntax: ${xrdb:<variable name>} or ${xrdb:<variable name>:<fallback value>}
    • Example usage:
main_fg       = ${xrdb:color14}
secondary_fg  = ${xrdb:foreground:#FFF}
main_bg       = ${xrdb:background}
You can’t perform that action at this time.