cli

Command-line tool to customize Spotify client. Supports Windows, MacOS, and Linux.

LGPL-2.1 License

Downloads
640
Stars
17.5K
Committers
102

Bot releases are hidden (Show)

cli - v2.33.1 (2024-02-29)

Published by rxri 8 months ago

compare changes

🩹 Fixes

  • logging: Return necessary values (#2870)

❤️ Contributors

  • ririxi (@rxri)

⚠️ Information to developers

We created a proxy over CosmosAsync (Spotify versions 1.2.31 and higher) and determine where it should land depending on the specified URL. External URIs (not api.spotify.com, spclient.wg.spotify.com, or sp://) will be redirected to our CORS proxy, which is also available without CosmosAsync at https://cors-proxy.spicetify.app. This proxy only accepts connections from the Spotify client.

Compatibility

We officially drop support for versions lower than 1.2.13. Spicetify may work with older versions than those listed, but we will not keep these versions in mind when developing updates.

  • Spotify for macOS: 1.2.13 -> 1.2.32
  • Spotify for Linux: 1.2.13 -> 1.2.31
  • Spotify for Windows/Microsoft Store: 1.2.13 -> 1.2.32
    • You may need to apply spicetify every time you close Microsoft Store version of Spotify
cli - v2.33.0 (2024-02-27)

Published by rxri 8 months ago

compare changes

🩹 Fixes

  • lyrics-plus: Disable genius for 1.2.31 and higher (#2859)
  • preprocess: Adapt regex to find react on 1.2.32 (#2863)

❤️ Contributors

  • ririxi (@rxri)

⚠️ Information to developers

We created a proxy over CosmosAsync (Spotify versions 1.2.31 and higher) and determine where it should land depending on the specified URL. External URIs (not api.spotify.com, spclient.wg.spotify.com, or sp://) will be redirected to our CORS proxy, which is also available without CosmosAsync at https://cors-proxy.spicetify.app. This proxy only accepts connections from the Spotify client.
We also removed Panel API with this release.

Compatibility

We officially drop support for versions lower than 1.2.13. Spicetify may work with older versions than those listed, but we will not keep these versions in mind when developing updates.

  • Spotify for macOS: 1.2.13 -> 1.2.32
  • Spotify for Linux: 1.2.13 -> 1.2.31
  • Spotify for Windows/Microsoft Store: 1.2.13 -> 1.2.32
    • You may need to apply spicetify every time you close Microsoft Store version of Spotify
cli - v2.32.1 (2024-02-20)

Published by rxri 8 months ago

compare changes

🩹 Fixes

  • Use different check for target in shouldAdd (#2853)

❤️ Contributors

  • ririxi (@rxri)

⚠️ Information to developers

We implemented a proxy over CosmosAsync (on 1.2.31 and higher) and determine where it should land based on the provided URL. External URIs (not api.spotify.com or spclient.wg.spotify.com or sp://) will be redirect by our CORS proxy that you can use without CosmosAsync as well and is available under https://cors-proxy.spicetify.app. This proxy only allows connections from spotify client

Compatibility

Spotify 1.2.18 and above doesn't have working custom panels. We plan to remove Panel API with v3 release.

  • Spotify for macOS: 1.2.0 -> 1.2.31
  • Spotify for Linux: 1.2.8 -> up to 1.2.31 (if it ever releases)
  • Spotify for Windows/Microsoft Store: 1.2.0 -> 1.2.31
    • You may need to apply spicetify every time you close Microsoft Store version of Spotify
cli - v2.32.0 (2024-02-20)

Published by rxri 8 months ago

compare changes

🚀 Enhancements

  • Add proxy for CosmosAsync calls (#2846)

🩹 Fixes

  • wrapper: Made profile menu button selector more precise (#2839)
  • wrapper/chunks: Add failsafe for 1.2.31 (#2840)

❤️ Contributors

  • ririxi (@rxri)
  • Delusoire (@Delusoire)

⚠️ Information to developers

We implemented a proxy over CosmosAsync (on 1.2.31 and higher) and determine where it should land based on the provided URL. External URIs (not api.spotify.com or spclient.wg.spotify.com or sp://) will be redirect by our CORS proxy that you can use without CosmosAsync as well and is available under https://cors-proxy.spicetify.app. This proxy only allows connections from spotify client

Compatibility

Spotify 1.2.18 and above doesn't have working custom panels. We plan to remove Panel API with v3 release.

  • Spotify for macOS: 1.2.0 -> 1.2.31
  • Spotify for Linux: 1.2.8 -> up to 1.2.31 (if it ever releases)
  • Spotify for Windows/Microsoft Store: 1.2.0 -> 1.2.31
    • You may need to apply spicetify every time you close Spotify in Microsoft Store version
cli - v2.31.3 (2024-02-15)

Published by rxri 8 months ago

What's Changed

⚠️ Warning to users

Since Spotify 1.2.31, Spotify removed a core functionality of the function that many extensions and custom apps used (e.g. lyrics-plus and more...) and because of this, these may not work properly (fetching lyrics etc.) at this moment. We are actively trying to come up with the solution. Thank you for your patience. For the time being, please downgrade to 1.2.30 or lower

Compatibility

Spotify 1.2.18 and above doesn't have working custom panels. PanelAPI has changed and there is no ETA for patch. We plan to remove Panel API with v3 release.

  • Spotify for macOS: 1.2.0 -> 1.2.31
  • Spotify for Linux: 1.2.8 -> up to 1.2.31 (if it ever releases)
  • Spotify for Windows/Microsoft Store: 1.2.0 -> 1.2.31
    • Spicetify may not work properly with Microsoft Store version
    • You may need to apply spicetify every time you close Spotify in Microsoft Store version

Full Changelog: https://github.com/spicetify/spicetify-cli/compare/v2.31.2...v2.31.3

cli - v2.31.2 (2024-02-10)

Published by rxri 8 months ago

What's Changed

Compatibility

Spotify 1.2.18 and above doesn't have working custom panels. PanelAPI has changed and there is no ETA for patch. We plan to remove Panel API with v3 release.

  • Spotify for macOS: 1.2.0 -> 1.2.30
  • Spotify for Linux: 1.2.8 -> up to 1.2.30 (if it ever releases)
  • Spotify for Windows/Microsoft Store: 1.2.0 -> 1.2.30
    • Spicetify may not work properly with Microsoft Store version
    • You may need to apply spicetify every time you close Spotify in Microsoft Store version

Full Changelog: https://github.com/spicetify/spicetify-cli/compare/v2.31.1...v2.31.2

cli - v2.31.1 (2024-02-08)

Published by rxri 8 months ago

What's Changed

Compatibility

Spotify 1.2.18 and above doesn't have working custom panels. PanelAPI has changed and there is no ETA for patch. We plan to remove Panel API with v3 release.

  • Spotify for macOS: 1.2.0 -> 1.2.30
  • Spotify for Linux: 1.2.8 -> up to 1.2.30 (if it ever releases)
  • Spotify for Windows/Microsoft Store: 1.2.0 -> 1.2.30
    • Spicetify may not work properly with Microsoft Store version
    • You may need to apply spicetify every time you close Spotify in Microsoft Store version

Full Changelog: https://github.com/spicetify/spicetify-cli/compare/v2.31.0...v2.31.1

cli - v2.31.0 (2023-02-02)

Published by rxri 9 months ago

What's Changed

Compatibility

Spotify 1.2.18 and above doesn't have working custom panels. PanelAPI has changed and there is no ETA for patch. We plan to remove Panel API with v3 release.

  • Spotify for macOS: 1.2.0 -> 1.2.30
  • Spotify for Linux: 1.2.8 -> 1.2.30
  • Spotify for Windows/Microsoft Store: 1.2.0 -> 1.2.30
    • Spicetify may not work properly with Microsoft Store version
    • You may need to apply spicetify every time you close Spotify in Microsoft Store version

New Contributors

Full Changelog: https://github.com/spicetify/spicetify-cli/compare/v2.30.0...v2.31.0

cli - v2.30.0 (2023-01-11)

Published by rxri 9 months ago

What's Changed

Compatibility

Spotify 1.2.18 and above doesn't have working custom panels. PanelAPI has changed and there is no ETA for patch. We plan to remove Panel API with v3 release.

  • Spotify for macOS: 1.2.0 -> 1.2.28
  • Spotify for Linux: 1.2.8 -> 1.2.28
  • Spotify for Windows/Microsoft Store: 1.2.0 -> 1.2.28
    • Spicetify may not work properly with Microsoft Store version
    • You may need to apply spicetify every time you close Spotify in Microsoft Store version

Full Changelog: https://github.com/spicetify/spicetify-cli/compare/v2.29.1...v2.30.0

cli - v2.29.1 (2024-01-01)

Published by rxri 10 months ago

What's Changed

⚠️ Breaking changes for developers

  • UserAPI._product_state has been replaced by UserAPI._product_state_service since Spotify 1.2.21.
  • Spicetify.Player.data.track property has been fully removed and has been replaced by Spicetify.Player.data.item.

Compatibility

Spotify 1.2.18 and above doesn't have working custom panels. PanelAPI has changed and there is no ETA for patch. We plan to remove Panel API with v3 release.

  • Spotify for macOS: 1.2.0 -> 1.2.28
  • Spotify for Linux: 1.2.8 -> 1.2.28
  • Spotify for Windows/Microsoft Store: 1.2.0 -> 1.2.28
    • Spicetify may not work properly with Microsoft Store version
    • You may need to apply spicetify every time you close Spotify in Microsoft Store version

Full Changelog: https://github.com/spicetify/spicetify-cli/compare/v2.29.0...v2.29.1

cli - v2.29.0 (2023-12-31)

Published by rxri 10 months ago

This is the last release for the year 2023. We'd like to wish everyone a happy new year and thank you for using spicetify 🎉!

What's Changed

⚠️ Breaking changes for developers

  • UserAPI._product_state has been replaced by UserAPI._product_state_service since Spotify 1.2.21.
  • Spicetify.Player.data.track property has been fully removed and has been replaced by Spicetify.Player.data.item.

Compatibility

Spotify 1.2.18 and above doesn't have working custom panels. PanelAPI has changed and there is no ETA for patch. We plan to remove Panel API with v3 release.

  • Spotify for macOS: 1.2.0 -> 1.2.28
  • Spotify for Linux: 1.2.8 -> 1.2.28
  • Spotify for Windows/Microsoft Store: 1.2.0 -> 1.2.28
    • Spicetify may not work properly with Microsoft Store version
    • You may need to apply spicetify every time you close Spotify in Microsoft Store version

Full Changelog: https://github.com/spicetify/spicetify-cli/compare/v2.28.1...v2.29.0

cli - v2.28.1 (2023-12-10)

Published by rxri 10 months ago

What's Changed

ℹ️ Information for users

  • The New Releases custom app no longer works with Spotify 1.2.25 and higher. As an alternative, please use What's New which was created by Spotify and can be enabled via Experimental Features if it isn't already enabled.

⚠️ Breaking changes for developers

  • UserAPI._product_state has been replaced by UserAPI._product_state_service since Spotify 1.2.21.
  • Spicetify.Player.data.track property has been fully removed and has been replaced by Spicetify.Player.data.item.

Compatibility

Spotify 1.2.18 and above doesn't have working custom panels. PanelAPI has changed and there is no ETA for patch. We plan to remove Panel API with v3 release.

  • Spotify for macOS: 1.2.0 -> 1.2.26
  • Spotify for Linux: 1.2.8 -> 1.2.26
  • Spotify for Windows/Microsoft Store: 1.2.0 -> 1.2.26
    • Spicetify may not work properly with Microsoft Store version
    • You may need to apply spicetify every time you close Spotify in Microsoft Store version

Full Changelog: https://github.com/spicetify/spicetify-cli/compare/v2.28.0...v2.28.1

cli - v2.28.0 (2023-12-05)

Published by afonsojramos 11 months ago

What's Changed

ℹ️ Information for users

  • The New Releases custom app no longer works with Spotify 1.2.25 and higher. As an alternative, please use What's New which was created by Spotify and can be enabled via Experimental Features if it isn't already enabled.

⚠️ Breaking changes for developers

  • UserAPI._product_state has been replaced by UserAPI._product_state_service since Spotify 1.2.21.
  • Spicetify.Player.data.track property has been fully removed and has been replaced by Spicetify.Player.data.item.

Compatibility

Spotify 1.2.18 and above doesn't have working custom panels. PanelAPI has changed and there is no ETA for patch

  • Spotify for macOS: 1.2.0 -> 1.2.25
  • Spotify for Linux: 1.2.8, 1.2.9, 1.2.11, 1.2.13, 1.2.20, 1.2.22, 1.2.25
  • Spotify for Windows/Microsoft Store: 1.2.0 -> 1.2.25
    • Spicetify may not work properly with Microsoft Store version
    • You may need to apply spicetify every time you close Spotify in Microsoft Store version

Full Changelog: https://github.com/spicetify/spicetify-cli/compare/v2.27.2...v2.28.0

cli - v2.27.2 (2023-11-23)

Published by rxri 11 months ago

What's Changed

⚠️ Breaking changes for developers

  • UserAPI._product_state has been replaced by UserAPI._product_state_service since Spotify 1.2.21.

Compatibility

Spotify 1.2.18 and above doesn't have working custom panels. PanelAPI has changed and there is no ETA for patch

  • Spotify for macOS: 1.2.0 -> 1.2.25
  • Spotify for Linux: 1.2.8, 1.2.9, 1.2.11, 1.2.13, 1.2.20, 1.2.22, 1.2.25
  • Spotify for Windows/Microsoft Store: 1.2.0 -> 1.2.25
    • Spicetify may not work properly with Microsoft Store version
    • You may need to apply spicetify every time you close Spotify in Microsoft Store version

New Contributors

Full Changelog: https://github.com/spicetify/spicetify-cli/compare/v2.27.1...v2.272

cli - v2.27.1 (2023-11-14)

Published by afonsojramos 11 months ago

What's Changed

New Contributors

⚠️ Breaking changes for developers

  • UserAPI._product_state has been replaced by UserAPI._product_state_service since Spotify 1.2.21.

Compatibility

Spotify 1.2.18 -> 1.2.24 doesn't have working custom panels. PanelAPI has changed and there is no ETA for patch

  • Spotify for macOS: 1.2.0 -> 1.2.24
  • Spotify for Linux: 1.2.8, 1.2.9, 1.2.11, 1.2.13, 1.2.20, 1.2.22
  • Spotify for Windows/Microsoft Store: 1.2.0 -> 1.2.24
    • Spicetify may not work properly with Microsoft Store version
    • You may need to apply spicetify every time you close Spotify in Microsoft Store version

Full Changelog: https://github.com/spicetify/spicetify-cli/compare/v2.27.0...v2.27.1

cli - v2.27.0 (2023-11-08)

Published by afonsojramos 12 months ago

What's Changed

❗ Semi-breaking changes to the CLI

  • The old spicetify update is now spicetify refresh and now supports Custom Apps as well.
  • Now you can update spicetify using spicetify update or spicetify upgrade if you're an old timer. 🧑‍🦳
    • Updating now automatically runs spicetify restore backup apply so no need for extra steps. 👌

⚠️ Breaking changes for developers

  • UserAPI._product_state has been replaced by UserAPI._product_state_service since Spotify 1.2.21.

Compatibility

Spotify 1.2.18 -> 1.2.23 doesn't have working custom panels. PanelAPI has changed and there is no ETA for patch

  • Spotify for macOS: 1.2.0 -> 1.2.24
  • Spotify for Linux: 1.2.8, 1.2.9, 1.2.11, 1.2.13, 1.2.20, 1.2.22
  • Spotify for Windows/Microsoft Store: 1.2.0 -> 1.2.24
    • Spicetify may not work properly with Microsoft Store version
    • You may need to apply spicetify every time you close Spotify in Microsoft Store version

Full Changelog: https://github.com/spicetify/spicetify-cli/compare/v2.26.0...v2.27.0

cli - v2.26.0 (2023-11-06)

Published by rxri 12 months ago

What's Changed

⚠️ BREAKING CHANGES FOR DEVELOPERS ⚠️

  • UserAPI._product_state has been replaced by UserAPI._product_state_service since Spotify 1.2.21.

Compatibility

Spotify 1.2.18 -> 1.2.23 don't have working custom panels. PanelAPI has changed and there is no ETA for patch

  • Spotify for macOS: 1.2.0 -> 1.2.23
  • Spotify for Linux: 1.2.8, 1.2.9, 1.2.11, 1.2.13, 1.2.20, 1.2.22
  • Spotify for Windows/Microsoft Store: 1.2.0 -> 1.2.23
    • Spicetify may not work properly with Microsoft Store version
    • You may need to apply spicetify every time you close Spotify in Microsoft Store version

Full Changelog: https://github.com/spicetify/spicetify-cli/compare/v2.25.3...v2.26.0

cli - v2.25.3 (2023-10-31)

Published by rxri 12 months ago

What's Changed

⚠️ BREAKING CHANGES FOR DEVELOPERS ⚠️

  • UserAPI._product_state has been replaced by UserAPI._product_state_service since Spotify 1.2.21.

Compatibility

Spotify 1.2.18 -> 1.2.23 don't have working custom panels. PanelAPI has changed and there is no ETA for patch

  • Spotify for macOS: 1.2.0 -> 1.2.23
  • Spotify for Linux: 1.2.8, 1.2.9, 1.2.11, 1.2.13, 1.2.20, 1.2.22
  • Spotify for Windows/Microsoft Store: 1.2.0 -> 1.2.23
    • Spicetify may not work properly with Microsoft Store version
    • You may need to apply spicetify every time you close Spotify in Microsoft Store version

Full Changelog: https://github.com/spicetify/spicetify-cli/compare/v2.25.2...v2.25.3

cli - v2.25.2 (2023-10-29)

Published by rxri 12 months ago

What's Changed

⚠️ BREAKING CHANGES FOR DEVELOPERS ⚠️

  • UserAPI._product_state has been replaced by UserAPI._product_state_service since Spotify 1.2.21.
  • Due to changes in Spotify 1.2.19, how we retrieve data for Spicetify.Player.data has also changed. Since v2.23.0 it now uses PlayerAPI._state to retrieve Player data, possibly leading to different variable names. Please update your extensions or custom apps accordingly to both changes
    • This is the last release that mentions this breaking change

Compatibility

Spotify 1.2.18 -> 1.2.23 don't have working custom panels. PanelAPI has changed and there is no ETA for patch

  • Spotify for macOS: 1.2.0 -> 1.2.23
  • Spotify for Linux: 1.2.8, 1.2.9, 1.2.11, 1.2.13, 1.2.20, 1.2.22
  • Spotify for Windows/Microsoft Store: 1.2.0 -> 1.2.23
    • Spicetify may not work properly with Microsoft Store version
    • You may need to apply spicetify every time you close Spotify in Microsoft Store version

Full Changelog: https://github.com/spicetify/spicetify-cli/compare/v2.25.1...v2.25.2

cli - v2.25.1 (2023-10-27)

Published by rxri 12 months ago

What's Changed

⚠️ BREAKING CHANGES FOR DEVELOPERS ⚠️

  • UserAPI._product_state has been replaced by UserAPI._product_state_service since Spotify 1.2.21.
  • Due to changes in Spotify 1.2.19, how we retrieve data for Spicetify.Player.data has also changed. Since v2.23.0 it now uses PlayerAPI._state to retrieve Player data, possibly leading to different variable names. Please update your extensions or custom apps accordingly to both changes

Compatibility

Spotify 1.2.18 -> 1.2.23 don't have working custom panels. PanelAPI has changed and there is no ETA for patch

  • Spotify for macOS: 1.2.0 -> 1.2.23
  • Spotify for Linux: 1.2.8, 1.2.9, 1.2.11, 1.2.13, 1.2.20, 1.2.22
  • Spotify for Windows/Microsoft Store: 1.2.0 -> 1.2.23
    • Spicetify may not work properly with Microsoft Store version
    • You may need to apply spicetify every time you close Spotify in Microsoft Store version

New Contributors

Full Changelog: https://github.com/spicetify/spicetify-cli/compare/v2.25.0...v2.25.1