github spicetify/spicetify-cli v2.0.0
Initial support for XPUI

latest releases: v2.36.1, v2.36.0, v2.35.1...
pre-release2 years ago

From v2.0.0, Spicetify solely works on XPUI interface only and is incompatible with legacy one. If you prefer legacy Spotify with fully themes, extensions, custom app support, please use Spicetify v1.2.1. This version is still experimental and there are a lot of work in progress:

  • Spicetify APIs are mostly implemented and are somewhat compatible with previous version. There are a few important changes you should know:

    • Spicetify.CosmosAPI is replaced with Spicetify.CosmosAsync. Please take a look at existing extensions and documentation in global.d.ts file to know how to use and modify your extensions accordingly.
    • Spicetify.ContextMenu is partly implemented, only Item is usable.
    • Spicetify.Menu is not implemented.
    • Spicetify.BridgeAPI, Spicetify.LiveAPI are deprecated.
    • Spicetify.getAblumArtColors is deprecated, please use Spicetify.colorExtractor instead.
    • Spicetify.PlaybackControl has completely new functions set. They are straight forward, easier to use and requires less parameters. Please revise global.d.ts for its new documentation.
  • New APIs:

    • Spicetify.Mousetrap: Keyboard shortcut library. Documentation: https://craig.is/killing/mice
    • Spicetify.Platform: Contains vast array of Spotify internal API, I don't have time to document them, please explore in devtool Console.
  • Elements class names are translated to more readable forms, hopefully they are consistent across versions. You can start working on your theme. But I have to remind you that your theme from legacy Spotify will not be compatible, hence you have to build new one from ground up.

  • Default extensions are partly working. Not working ones are temporarily removed, they are probably added later if I have time to update them.

  • Reddit app is removed. I haven't found a replacement for custom apps since new Spotify does not rely on iframe anymore.

  • New config file should locate at same place as your previous config file but its name now is config-xpui.ini

To install, please use the same install script but annotate version parameter:
Windows:

Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/khanhas/spicetify-cli/master/install.ps1" -OutFile $env:TEMP\install.ps1
Invoke-Expression "$env:TEMP\install.ps1 2.0.0"

Linux/MacOS:

curl -fsSL https://raw.githubusercontent.com/khanhas/spicetify-cli/master/install.sh -o /tmp/install.sh
sh /tmp/install.sh 2.0.0

Don't miss a new spicetify-cli release

NewReleases is sending notifications on new releases.