Spicetify v2
This section documents Spicetify v2, the released, stable CLI. It is still what install.sh and install.ps1 give you by default, and it is what most people are running today.
Spicetify v3 is the rewrite: one kind of add-on instead of four, a store inside Spotify, and a client that repairs itself after Spotify updates. It is the current version; this section stays while v2 is still supported.
Using v2
- Getting started installs v2 and applies it
- Customization covers the Marketplace, themes, extensions and custom apps
- Configuration reference documents
config-xpui.ini - CLI reference documents the v2 commands
- Uninstallation
- FAQ
Developing for v2
- Themes, extensions and custom apps
- JS modules
- Spicetify Creator, the v2 authoring toolchain
In v3 all of the above are one thing, a module.
The API reference is shared
The Spicetify global that v2 extensions use is the same surface v3 modules get, so the API reference is not duplicated here. It applies to both.