v2.6.2

Adds

• Configurable blur size to popup lyrics (Thanks @ZT2wo)
• Minor version tag support for CSS mappings (Thanks @itsmeow)
• CSS Mappings (Thanks @TheGeeKing)

Instructions

Install by running:

spicetify upgrade

Make sure you run this after upgrading:

spicetify restore backup apply

v2.6.1

Fixes

• Updated CSS Map

Instructions

Install by running:

spicetify upgrade

Make sure you run this after upgrading:

spicetify restore backup apply

v2.6.0

Fixes:

• Spicetify.ReactComponent.ContextMenu hook
• Spicetify.ReactComponent.RightClickMenu hook
• Spicetify.ReactComponent.Menu hook
• Spicetify.React hook
• Spicetify.Platform hook
• Removes disable_sentry hook, meaning it no longer needs to be disabled in the config
• App React symbol injection
• Spicetify.Player.getProgress() and getProgressPercent() functions

Instructions

Install by running:

spicetify upgrade

Make sure you run this after upgrading:

spicetify restore backup apply

v2.5.0

Change

• Custom assets location: in previous version, Spotify allowed us to put assets some extra files supporting theme in "glue-resources" folder and access them via url "https://local_resources_host/". From v1.1.62, the feature was taken away so this location change is to reflect that. Custom assets are now placed in "xpui" and can be accessed directly.

For example, my theme requires "placeholder.svg" file. To make it available to use, put it in assets folder and make sure overwrite_assets field in config file is on.

MINE
├───assets
│   └───placeholder.svg
├───colors.ini
└───user.css

In CSS, you can query them as if it's a local file:

.playlist {
    background-image: url("./placeholder.svg");
}

Or Javacsript:

const svgContent = await fetch("placeholder.svg")

You can take advantage of this to replace stock assets, change some images files that you don't like how they look. If you just want add extra files, it's best practice to put your files in a deeper folder so you don't accidentally replace anything.

Fix

• Missing login page
• home_config and sidebar_config should definitely work stably now. Try them out if you haven't.

Make sure you run this after upgrading:

spicetify restore backup apply

Notes to Dribbblish theme users: Update the theme, there are some major changes.

v2.4.0

Fix

• new-releases: Relative date doesn't save
• fullAppDisplay: append to body directly instead of video container
• popupLyrics: script path for worker
• "appchange" event for Home page
• sidebar_config: Items overlap with scrollbar

Change

• Some colors and CSS tunes for SpicetifyDefault theme.
• Refactor Spicetify.Menu and Spicetify.ContextMenu:
  • Spicetify.ContextMenu.SubMenu no longer has icon parameter.
  • Note for extension makers: All of public interfaces are still the same, some extra method are added. But if you are using internal members, there are some changes internally so you might want to double check.

If you had problem with home_config in v2.3.0, they should be fixed now. After upgrade spicetify, please run:

spicetify restore backup apply

v2.3.0

Add

• Additional option "sidebar_config": Enable ability to arrange and hide items on sidebar.
  • Turn on "Sidebar config" mode in Profile menu (top right button with your username), then hover on sidebar items (not playlists) to show customization buttons.
  • There are 3 regions: Stick, Normal and Hidden. Items in Stick region would stay up top and on top all the time. Items in Normal region would scroll when you scroll on the sidebar.
  • Remember to turn off "Sidebar config" mode after you finish customizing.

• Additional option "home_config": Enable ability to arrange sections in Home page.
  • Navigate to Home page, turn on "Home config" mode in Profile menu, then hover on sections to show customization buttons.
  • There are 3 regions: Stick, Normal and Lowered. Items in Stick region would stay up top and can be re-arrange. It's useful for some sections you particular like but Spotify somehow put them way too far down. Item in Normal region would stay as they are originally and can't be re-arranged. Items in Lowered region would be pushed to bottom. Put sections you don't like in there.
  • Some sections are always available in Home page. Some sections are more situational and dynamic (e.g: Christmas, genres, ...), their availabilities depend on when Spotify wants them to promote to you. And I have no control over that, so don't report bug when one of your sticky sections disappears.

• Spicetify.Locale API: Get UI text using stock i18n.
  • Custom apps names and a few UI text in custom apps are also applied Spicetify.Locale. They should show up in your language now.

Fix

• Patch fix for v1.1.62
• Lyrics Plus app: add Genius new page layout parser.

v2.2.7

Change

• Reddit app: display posts as soon as possible, instead of waiting until all post are fetched. Useful for users who live in country with garbage internet like Australia.
• Lyrics Plus app: scroll to top when track changes (in unsynced and genius mode).
• Reddit, Lyrics Plus, New Releases app: Move config menu button into Profile menu (top right button with your username).
• Reddit, Lyrics Plus app: top bar items and sort popup menu should look like native popup menu now.
• Spicetify.Player.addEventListener: re-add "appchange" event. Please revise global.d.ts for updated documentation.

Fix

• Lyrics Plus app: colorful background bug
• Lyrics Plus app: Genius alternative format causes repeated annotation bug
• Bookmark ext: add bookmark playlist from context menu and bookmark bug from context menu in friends sidebar
• Shuffle+ ext: multiple track selections shuffle

Please make sure you run:

spicetify restore backup apply

after upgrading spicetify to receive these new changes and fixes.

v2.2.6

Add

• Bookmark extension: bookmark from context menu #731

• New Releases app: new configurations

  • Date locale: Override date language and format. You should input a locale code if you want it to be in your language or a specific flavor of your language. #712
  • Relative date: Switch to relative date format, e.g.: "Today", "Yesterday", "2 Days ago", ...

• Spicetify.Topbar API: Easier way for your extension to add a button in top bar. Check example usage in default extensions.

Change

• Thinner icons for lyrics-plus and new-releases #706 (Thanks @JulienMaille)
• Pop modal Close button color #707 (Thanks @JulienMaille)
• Lyrics Plus app: Fallback queries for Genius when title has extra information like "feat." or "Remaster". #703
• Lyrics Plus app: Genius annotations show underline when hover on #736

Fix

• Submenu causes crash when user hits a keyboard modifier
• New Release ext: Podcast fetch cause crash #737
• Lyrics Plus app: Genius annotation blocked mouse click #714
• Full App Display ext: Edge case when there is no local file album title, uri #704
• Tab bar in reddit and lyrics-plus should be more adaptive now. #677

v2.2.5

Add

• Re-add Bookmark extension: Store and access pages, play tracks or tracks in specific time. Useful for who wants to check out an artist, album later without following them or writing their names down. Tracks are context-awared, accessing or playing them will put it to context that it was bookmarked from.
  

• Noisy background option for Lyrics Plus

Fix

• Fatal bug when generating spicetify-config.json #699
• Login page no longer be modded #697

Previous release note (in case you missed it): https://github.com/khanhas/spicetify-cli/releases/tag/v2.2.4

v2.2.4

Add

• New custom app New Releases: Aggregate all fresh releases from your followed artists and podcasts. Release types filter, time range are customizable via Settings menu. Remember to hit Refresh after configuring.
  
• Lyrics Plus:
  • Settings menu: You can customize colors, swap providers priority and input Musximatch token now.
  • Version selector for Genius mode: If there are multiple versions or translations found, just select from drop down menu and it will switch to chosen version.
    
• Reddit, New Releases apps' cards can be right clicked to open their context menus now
• Generate spicetify-config.json file in app folder. It contains current theme name, current color scheme name and all color schemes. #624

const spiceConfig = await fetch("spicetify-config.json").then(a => a.json);
console.log(spiceConfig.theme_name, spiceConfig.scheme_name, spiceConfig.schemes);

Fix

• A few bug with Musixmatch and Genius verified annotation in Lyrics Plus
• Full App Display progress bar length inconsistency #651 Thanks @BluTree
• Typos in Lyrics Plus #654 Thanks @Kamefrede
• Webnowplaying info delayed bug when playing on another device

Improvement

• Shuffle+ fetch playlist, library way faster by using protobuf request.
• Spicetify.PopupModal can mount a React element as now (check New Release and Lyrics Plus "Settings.js" for example usage)