Snoooopy/SpotX-Bash
1
0
Fork 0
mirror of https://github.com/SpotX-Official/SpotX-Bash.git synced 2026-04-21 18:40:19 +10:00
Code Issues Packages Projects Releases Wiki Activity

Initial commit

jetfir3
2023-02-14 01:16:29 +00:00
commit f6a4c2e7a0
3 changed files with 413 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

274
SpotX‐Bash-FAQ.md Normal file

@@ -0,0 +1,274 @@
- [General Questions](#general-questions)
* [How to use this?](#how-to-use-this)
* [Which platforms and versions does SpotX-Bash support?](#which-platforms-and-versions-does-spotx-bash-support)
* [Will SpotX-Bash ever support other platforms?](#will-spotx-bash-ever-support-other-platforms)
* [Why does SpotX-Bash say "Failed to connect", "Could not be resolved" or other cURL errors?](#why-does-spotx-bash-say-failed-to-connect-could-not-be-resolved-or-other-curl-errors)
* [Why doesn't SpotX-Bash work with my shell?](#why-doesnt-spotx-bash-work-with-my-shell)
* [Does SpotX-Bash provide free Spotify Premium?](#does-spotx-bash-provide-free-spotify-premium)
* [Does SpotX-Bash provide access to lyrics?](#does-spotx-bash-provide-access-to-lyrics)
* [Does SpotX-Bash work on all Spotify updates?](#does-spotx-bash-work-on-all-spotify-updates)
* [Can SpotX-Bash be used with a paid Premium account?](#can-spotx-bash-be-used-with-a-paid-premium-account)
* [Can SpotX-Bash be used in any region?](#can-spotx-bash-be-used-in-any-region)
* [Why are there still ads when using Spotify Connect, AirPlay, Casting, etc?](#why-are-there-still-ads-when-using-spotify-connect-airplay-casting-etc)
* [Are there security concerns with SpotX-Bash?](#are-there-security-concerns-with-spotx-bash)
* [Is SpotX-Bash safe for my account?](#is-spotx-bash-safe-for-my-account)
* [Can SpotX-Bash and Spicetify be used together?](#can-spotX-bash-and-spicetify-be-used-together)
* [Why does SpotX-Bash say "Spotify not found" when Spotify is installed?](#why-does-spotx-bash-say-spotify-not-found-when-spotify-is-installed)
* [Why doesn't SpotX-Bash have "x" feature?](#why-doesnt-spotx-bash-have-x-feature)
* [What is Developer Mode?](#what-is-developer-mode)
* [What is the "old" and "new" UI?](#what-is-the-old-and-new-ui)
* [How can I troubleshoot issues?](#how-can-i-troubleshoot-issues)
- [Linux Questions](#linux-questions)
* [How to install Spotify on my Linux distro?](#how-to-install-spotify-on-my-linux-distro)
* [What is the Spotify/Linux compatibility list?](#what-is-the-spotifylinux-compatibility-list)
* [Is the Snap version of Spotify supported?](#is-the-snap-version-of-spotify-supported)
- [macOS Questions](#macos-questions)
* [How to install Spotify on my Mac?](#how-to-install-spotify-on-my-mac)
* [What is the Spotify/macOS compatibility list?](#what-is-the-spotifymacos-compatibility-list)
* [What does codesigning have to do with SpotX-Bash and Spotify?](#what-does-codesigning-have-to-do-with-spotX-bash-and-spotify)
# General Questions
## How to use this?
In short -- install Spotify desktop client then run the SpotX-Bash command mentioned in the README.
Expanding on the directions in the `README.md`...
after installing Spotify on [Linux](#how-to-install-spotify-on-my-linux-distro) or [macOS](#how-to-install-spotify-on-my-mac), `SpotX-Bash` needs to be manually run to add its features to the installed Spotify client. Running the `bash <(curl...` command in the [README.md](https://github.com/SpotX-Official/SpotX-Bash#usage) is recommended as this will always run the latest version of the script which may be required to support more recent Spotify client versions.
By default, `SpotX-Bash` is for free-tier Spotify users and enables experimental features supported by the installed client version. Paid premium subscribers or those who wish to customize features can use the additional options listed in the [README.md](https://github.com/SpotX-Official/SpotX-Bash#usage). Example commands can be found in the expanded `Options` section of the `README.md`.
`SpotX-Bash` will need to run each time Spotify is installed, re-installed or updated. Alternatively, you can not update Spotify and continue using the `SpotX-Bash` patched build for as long as you want. The Linux client does not have an auto-updater but may or may not automatically be updated by the package manager, review update settings for your package manager. The macOS client does have an auto-updater built in but using the `SpotX-Bash` option, `-B`, will block the updater from running.
## Which platforms and versions does SpotX-Bash support?
`SpotX-Bash` supports Spotify desktop clients on Linux and macOS. As of May 2023, Spotify has disabled `v1.1.58.820` and below. Technically, `SpotX-Bash` should work on all currently working versions of Spotify... `v1.1.59.710` and up.
For Linux, Spotify does not post official system requirements. Generally, as long as your distro of choice can install Spotify `v1.1.59.710` or higher (+ any required dependencies) then `SpotX-Bash` will work. Spotify for Linux is built for x86_64 (64-bit) systems only (no x86 (32-bit) or ARM/ARM64 builds as of this writing).
For macOS, due to versions `v1.1.58.820` and below being disabled by Spotify, OS X 10.10 and below no longer support an official working Spotify desktop client. OS X 10.11+ is required.
While `SpotX-Bash` may work with `v1.1.59.710`, the focus of SpotX-Bash is to support the current latest official client and Spotify v1.2.13.661+ is recommended for both Linux and macOS when possible. For a lighter weight client build or older OS, try 1.1.84.716 or 1.1.89.862.
## Will SpotX-Bash ever support other platforms?
No, `SpotX-Bash` will only support Linux and macOS. [SpotX](https://github.com/SpotX-Official/SpotX) is available for Windows, [xManager](https://github.com/Team-xManager/xManager) is available for Android and [SpotC](https://github.com/SpotCompiled/) lists various options for iOS.
## Why does SpotX-Bash say "Failed to connect", "Could not be resolved" or other cURL errors?
This error is not directly caused or related to `SpotX-Bash` but an issue somewhere between Github servers and your computer/network.
- Some ISPs and networks block `raw.githubusercontent.com` or `github.io`
- cURL is unable to verify the SSL certificate
- Github may be having server issues
- URL used may have a typo
Due to `raw.githubusercontent.com` blocking being more common, `github.io` is now the default URL mentioned in the README.md but either URL is an option if one isn't working or is preferred over another...
- github.io:
```
bash <(curl -sSL https://spotx-official.github.io/run.sh)
```
- raw.githubusercontent.com:
```
bash <(curl -sSL https://raw.githubusercontent.com/SpotX-Official/SpotX-Bash/main/spotx.sh)
```
For certificate-related errors, adding `-k` to the curl arguments (`curl -k -sSL https...`) may bypass the error, however, resolving the SSL/certificate issue is recommended.
The `spotx.sh` file could also be downloaded from the repo to run locally -- it will do the same thing as running the bash/curl commands above however this is not ideal since `SpotX-Bash` is constantly being updated to support the latest Spotify versions. A local copy of the script is quickly outdated and may not work correctly with future Spotify versions, requiring downloading the latest version each time Spotify is updated.
## Why doesn't SpotX-Bash work with my shell?
The default recommended `SpotX-Bash` command in the [README.md](https://github.com/SpotX-Official/SpotX-Bash#usage) assumes the use of a Bash-compliant shell.
Shells which are not Bash-compliant may have issues with the recommended `SpotX-Bash` `bash <(curl...` command format. Refer to your shell documentation for the suggested handling of process substitution.
Below are two examples of a "more universal" format which may work with your shell. When using additional options, `-s --` will need to precede all `SpotX-Bash` options.
**Example w/o options:**
```
curl -sSL https://spotx-official.github.io/run.sh | bash
```
**Example w/options:**
```
curl -sSL https://spotx-official.github.io/run.sh | bash -s -- -cfh
```
## Does SpotX-Bash provide free Spotify Premium?
No, `SpotX-Bash` blocks ads and may enable some normally restricted client settings. Premium features such as _**Very High**_ audio, group session listening, AI DJ, AI playlists, music downloading and offline playback require a paid Premium subscription.
## Does SpotX-Bash provide access to lyrics?
No, not for free-tier accounts. As of May 1, 2024 Spotify has restricted lyrics to paid-premium subscribers only. Spotify first started testing this behavior in August 2023 and removed lyrics for some songs, accounts, regions.
All free-tier users will no longer have access to lyrics directly from Spotify. Lyrics will not return to client unless external lyric sources are added or Spotify officially changes their decision.
## Does SpotX-Bash work on all Spotify updates?
`SpotX-Bash` needs to run each time Spotify is installed, re-installed or updated. Just as new Spotify updates are released, updates to the `SpotX-Bash` script are needed to continue working as expected. A brand new Spotify update may not yet work with the current SpotX-Bash version -- check the latest supported Spotify client version mentioned at the top of the repo [README.md](https://github.com/SpotX-Official/SpotX-Bash/#readme) to confirm `SpotX-Bash` will support your client version.
For Linux users, the Spotify client does not update itself via in-app update services and depends on the specific package manager or installation method used.
For macOS users, the Spotify client has an in-app updater and will update itself automatically when a new version is available. `SpotX-Bash` has the option to block updates and/or install the latest supported (or a previous) Spotify version then patch it after installation -- it is recommended to install Spotify and block updates using `SpotX-Bash` so the Spotify client never auto-updates itself to a version not yet supported by `SpotX-Bash`.
## Can SpotX-Bash be used with a paid Premium account?
Yes, `SpotX-Bash` supports Premium-tier users and should be run with the `-p` flag to skip the usual modifications done for free-tier users.
## Can SpotX-Bash be used in any region?
`SpotX-Bash` itself is not limited by any region but Spotify may not be supported in your region and workarounds such as using a VPN or proxy may be required. Additionally, _**South Korea**_ is currently the only officially supported Spotify region that does NOT have a free-tier (outside of a trial subscription) and therefore users in South Korea who wish to use the Spotify free-tier must also use a VPN or proxy.
**Using a Spotify account outside of officially supported regions is outside the scope of this project and further discussion of bypassing those limitations will not be supported in this repo.**
## Why are there still ads when using Spotify Connect, AirPlay, Casting, etc?
When using any of these methods to play audio/video, the media is no longer coming from the desktop client and, instead, is being controlled by the Spotify API outside of the modified client. Since `SpotX-Bash` only modifies the desktop client and not your actual Spotify account, ads cannot be blocked when audio/video is not coming directly from the modified desktop client. Yes, you may be using the desktop client to control the play/pause/stop/skip functions while the audio/video is on another device, but the audio/video itself is no longer sourced from the desktop client where `SpotX-Bash` has made the modifications.
## Are there security concerns with SpotX-Bash?
No, I don't believe there is anything unsafe with this script. The sole purpose of this project is ad blocking and enabling additional experimental features (most of which are official from Spotify).
No logging or anything outside of the exact purpose of `SpotX-Bash` is done by this script. Of course, everything this script does can be reviewed by anyone. If an unintended security issue is discovered due to improper use of Bash or one of the components used in the script, it can be reported using the Github [security advisory template](https://github.com/SpotX-Official/SpotX-Bash/security/advisories/new).
## Is SpotX-Bash safe for my account?
While there are no known instances of any `SpotX-Bash` users losing their Spotify accounts specifically from `SpotX-Bash` (or other ad blocking methods)... Spotify itself may have issues with blocking ads. `SpotX-Bash` does nothing related to copying/downloading/ripping music which are all things known to cause account issues. The only goal here is to remove ads and enable new (official) features which may not always be available to all by default due to Spotify a/b testing -- but use at your own risk and review the official terms and conditions for your region.
## Can SpotX-Bash and Spicetify be used together?
Technically, yes. If using both `SpotX-Bash` and Spicetify, it is required to run `SpotX-Bash` before setting up Spicetify. Any issues appearing after setting up Spicetify is outside the scope of this project/repo and issues should **not** be reported here.
Using both together is not "officially supported" by either SpotX or Spicetify and it is on the user if running into issue.
## Why does SpotX-Bash say "Spotify not found" when Spotify is installed?
In some cases, `SpotX-Bash` may be unable to find Spotify in its installed path. For these situations, the `-P [path]` flag must be used along with the usual `SpotX-Bash` command.
_For Linux_ -- `SpotX-Bash` should auto-detect installations via APT, dpkg, Flatpak (user/system), pacman, RPM Fusion and spotify-launcher. If installation is not auto-detected use the `-P [path]` option, pointing to the full path of the the spotify directory where the main executable binary for Spotify is found.
For example, if using the standard Flatpak installation of Spotify and the spotify executable is located at `/var/lib/flatpak/app/com.spotify.Client/x86_64/stable/active/files/extra/share/spotify/spotify` then you would add `-P /var/lib/flatpak/app/com.spotify.Client/x86_64/stable/active/files/extra/share/spotify/` to the `SpotX-Bash` command and the installation should be found.
Flatpak user installations default to: `$HOME/.local/share/flatpak/app/com.spotify.Client/x86_64/stable/active/files/extra/share/spotify/`
deb installations via APT or dpkg default to: `/usr/share/spotify/`
AUR installations default to: `/opt/spotify/`
spotify-launcher installations default to: `$HOME/.local/share/spotify-launcher/install/usr/share/spotify`
RPM installations default to: `/usr/share/spotify-client/`
_For macOS_ -- use the full path where `Spotify.app` is located. Default path for all macOS apps is in the /Applications/ directory.
For example, if Spotify.app is located at `/Applications/MyStuff/Spotify.app` then you would add `-P /Applications/MyStuff/` to the `SpotX-Bash` command and the installation should be found.
## Why doesn't SpotX-Bash have "x" feature?
The goal of `SpotX-Bash` is blocking ads and enabling official experimental features.
Customization beyond this is outside the scope of this project. Additionally, the goal is to always support the latest available Spotify client versions whenever possible therefore older Spotify versions may not always work with or be fully supported by the current script version.
Availability of features also depends on the client version installed, Spotify changes things all the time. See the [Spotify Desktop Client Version Timeline](https://github.com/SpotX-Official/SpotX-Bash/wiki/Spotify-Desktop-Client-Version-Timeline) for details on some of changes between versions.
## What is Developer Mode?
`Developer Mode` enables additional features built into the Spotify desktop client which are normally hidden for regular users. For example, since Spotify is built to use the [Chromium Embedded Framework](https://www.spotify.com/opensource/), the same "Developer Tools" built into Chrome/Chromium become available. Additional features include the `Debug Window` which allows granular controls of many Spotify experimental settings normally controlled by Spotify's `Remote Config` (or by `SpotX` / `SpotX-Bash`).
There are many more features available but many of which should probably be left alone unless you know what you're doing or don't mind risking breaking your Spotify install. If it does end up breaking after poking the wrong thing, wiping Spotify app cache (run `SpotX-Bash` with `-c`/`--clearcache`) will hopefully wipe any customization done with devmode.
To get to various `Developer Mode` menus/settings once it's been enabled:
- right-click in various areas of the app to reveal additional menus
- select the `Develop` menu added to the Spotify toolbar (macOS only)
- click your Spotify user icon > select Debug Window from the drop down menu
The `SpotX-Bash` developer mode is "permanent" and will be enabled until you upgrade/downgrade/reinstall the Spotify app.
`SpotX-Bash` supports developer mode in versions `1.1.84.716` and up. Versions newer than what `SpotX-Bash` officially supports may not work.
A script for _temporary_ `Developer Mode` can be found [here](https://gist.github.com/jetfir3/d66f491d0683e2bdbdf9f60068e9984b). The advantage of the temp script is that it supports nearly all working Spotify builds, both old and new. The "downside" to the script is that dev mode is temporary and likely to only work until you quit Spotify. To access dev mode again, the script would need to be used each time. Changes you've made to experimental features while in dev mode will stick regardless of whether dev mode is currently enabled or not.
## What is the "old" and "new" UI?
The "old" theme was the default UI that Spotify users should be familiar with if they used the desktop or web clients from 2021-2023 (and possibly earlier). In early 2021 the desktop and web clients [merged code bases and started using the same UI](https://engineering.atspotify.com/2021/04/building-the-future-of-our-desktop-apps/). While in 2021 that UI may have been new, in 2023 it has become what we now call the "old" UI. In mid-2022, Spotify started experimenting with some search bar changes. Towards the end of 2022 they were testing a new left sidebar and in 2023, a new right sidebar. The [updated left/right sidebars](https://newsroom.spotify.com/2023-06-20/spotify-desktop-experience-redesign-your-library-now-playing-views-customize/) are what we are calling the "new" UI.
From late 2022 through mid-2023, both the old and new UIs were available in the app and could be controlled via Spotify A/B testing (or through dev mode and mods like SpotX/etc). But starting with v1.2.14.x, the "old" UI was removed from the client and no longer an option. Spotify v1.2.13.661.ga588f749 is the last version which could use the "old" UI.
If a user sets the `-o` option with v1.2.14+, `SpotX-Bash` will report an error about the detected client version no longer supporting the old UI ( then continue running the rest of the script). Users who prefer the "old" look should use v1.2.13.661.ga588f749 or earlier and NOT update the client. Mac users can have `SpotX-Bash` block Spotify's built-in auto-updates. Linux users will need to look into their distro package manager (or other installation method) to see how to avoid updates.
## How can I troubleshoot issues?
Ideally, most issues should be unrelated to `SpotX-Bash` directly and, instead, are issues between Spotify itself and the computer it's installed on. To rule out `SpotX-Bash` issues, a full uninstall of Spotify and reinstallation of Spotify (without applying `SpotX-Bash`) should be attempted to confirm where the issue starts. All tests should be conducted on the exact same desktop client version to avoid missing Spotify version-specific bugs which may get blamed on `SpotX-Bash`.
See the [TROUBLESHOOTING](https://github.com/SpotX-Official/SpotX-Bash/wiki/Troubleshooting) section of the wiki for more info.
# Linux Questions
## How to install Spotify on my Linux distro?
Spotify officially supports installations with Snap via Snap Store and DEB via APT, however, Snap installations are _NOT_ supported by SpotX-Bash -- see [here](https://github.com/SpotX-Official/SpotX-Bash/wiki/SpotX%E2%80%90Bash-FAQ#is-the-snap-version-of-spotify-supported) more info.
You can visit Spotify's [Linux download page](https://www.spotify.com/download/linux/) for Debian / Ubuntu / APT-based instructions or use SpotX-Bash to install the APT-based client variant. While SpotX-Bash will only _install_ the DEB Spotify client on APT-based distros, it can still patch other distro/client variants after the user first installs Spotify.
Testing branch:
```
bash <(curl -sSL https://spotx-official.github.io/run.sh) --installdeb
```
Stable branch:
```
bash <(curl -sSL https://spotx-official.github.io/run.sh) --installdeb --stable
```
Other distros or client variants will have their own specific methods of installation which all repackage the official snap or deb to work, some methods are covered below. Use your search engine of choice if more info is needed -- it's your job to install Spotify, `SpotX-Bash`'s to patch it once installed. `SpotX-Bash` supports patching all* installation methods outside of Snap.
- [Flatpak](https://flathub.org/apps/com.spotify.Client) is a distro-neutral installation method, the Spotify install is based on the Spotify snap file with some additional patches applied.
- Red Hat/Fedora-based distros using RPM-based installations can use [RPM Fusion](https://docs.fedoraproject.org/en-US/quick-docs/installing-spotify/#_using_the_rpm_fusion_repository) repos.
- Arch-based users can install using [AUR/pacman/spotify-launcher](https://wiki.archlinux.org/title/spotify).
*nixOS has a unique way of isolating their Spotify installation. An [Issue](https://github.com/SpotX-Official/SpotX-Bash/issues/38) was raised on this topic and several [workarounds](https://github.com/SpotX-Official/SpotX-Bash/issues/38#issuecomment-2122912898) were mentioned (though perhaps not ideal). Using [Flakes](https://nixos.wiki/wiki/Flakes), it may be possible to properly solve this issue but this most likely won't be something officially solved by SpotX-Bash. Using the Flatpak build on nixOS is another alternative.
## What is the Spotify/Linux compatibility list?
Spotify does not officially list system requirements however they only build for x86_64 (64-bit) machines and require client version `1.1.59.710` and higher. As of May 2024 and the latest client version, `1.2.31.1205`, the Spotify repo lists the following:
```
Depends: libc6 (>= 2.30), libasound2, libatk-bridge2.0-0, libatomic1, libcurl3-gnutls, libgbm1, libglib2.0-0, libgtk-3-0, libnss3, libssl3 | libssl1.1 | libssl1.0.2 | libssl1.0.1 | libssl1.0.0, libxshmfence1, libxss1, libxtst6, xdg-utils, libayatana-appindicator3-1
Recommends: libavcodec58 | libavcodec-extra58 | libavcodec57 | libavcodec-extra57 | libavcodec-ffmpeg56 | libavcodec-ffmpeg-extra56 | libavcodec54 | libavcodec-extra-54, libavformat58 | libavformat57 | libavformat-ffmpeg56 | libavformat54
Suggests: libnotify4
```
## Is the Snap version of Spotify supported?
No, `SpotX-Bash` does not support Spotify from Snap.
Spotify from Snap is a read-only image file which requires additional steps and dependencies if trying to modify the app. `SpotX-Bash` _does_ support Spotify installs using Flatpak or distro-specific installation methods. If Snap installation is preferred, there are Spotify Snap files pre-patched with `SpotX-Bash` located in the SpotX [Telegram community](https://t.me/SpotxCommunity).
# macOS Questions
## How to install Spotify on my Mac?
Spotify's official download page can be found [here](https://www.spotify.com/download/other/).
`SpotX-Bash` has the option to download and install the official Spotify desktop client, downloaded directly from Spotify's CDN. You can use the `--installmac` option or enable interactive mode (`-i`) to have `SpotX-Bash` download and install the latest `SpotX-Bash`-supported Spotify version or use `-V [version]` option while specifying a version number to choose a previous Spotify version. After `SpotX-Bash` downloads and installs Spotify it will continue with the usual patches it performs on the installed client.
The following command installs the latest available version for your OS:
```
bash <(curl -sSL https://spotx-official.github.io/run.sh) --installmac
```
The following command installs a specific version (1.2.20.1218 is used as an example):
```
bash <(curl -sSL https://spotx-official.github.io/run.sh) -V 1.2.20.1218
```
## What is the Spotify/macOS compatibility list?
As of May 2023, Spotify has disabled `v1.1.58.820` and below. Therefore, OS X 10.11 or higher is required to use the official desktop client.
**As of May 2024, v1.2.38.720 and higher now requires macOS 11+.**
The last version of Spotify to work with OS X 10.11/macOS 10.12 is `1.1.89.862`.
The last version of Spotify to work with macOS 10.13/10.14 is `1.2.20.1218`.
The last version of Spotify to work with macOS 10.15 is `1.2.37.701`.
SpotX-Bash will automatically install the latest supported version supported by your OS by using the `--installmac` argument with the script.
## What does codesigning have to do with SpotX-Bash and Spotify?
`SpotX-Bash` patches the client in various ways to enable its features. Depending on your version of macOS and your specific security settings related to macOS Gatekeeper and System Integrity Protection, modifying the client may cause various macOS protections to trigger and not launch the app. To bypass this potential issue, `SpotX-Bash`, by default, uses codesign to re-sign the Spotify desktop app after `SpotX-Bash` has modified it which should then make macOS "happy" and launch the modified app without issue.
You can read a more detailed breakdown of this information in the [Discussions section](https://github.com/SpotX-Official/SpotX-Bash/discussions/3) of this repo.

53
Spotify-Desktop-Client-Version-Timeline.md Normal file

@@ -0,0 +1,53 @@
* [v1.2.37.701](#v1237701)
* [v1.2.33.x](#v1233x)
* [v1.2.32.x](#v1232x)
* [v1.2.26.x](#v1226x)
* [v1.2.24.x](#v1224x)
* [v1.2.20.1218](#v12201218)
* [v1.2.14.x](#v1214x)
* [v1.2.7.1277](#v1271277)
* [v1.2.5.1006](#v1251006)
* [v1.1.89.862](#v1189862)
* [v1.1.86.857](#v1186857)
* [v1.1.66.578](#v1166578)
* [v1.1.59.710](#v1159710)
## v1.2.37.701
- The last version of Spotify to work with macOS 10.15.
## v1.2.33.x
- [Canvas videos](https://artists.spotify.com/canvas) added to client
## v1.2.32.x
- Chrome runtime enabled
## v1.2.26.x
- [Enhance button](https://newsroom.spotify.com/2021-09-09/get-perfect-song-recommendations-in-the-playlists-you-create-with-enhance/) has been removed completely. The shift to [Smart Shuffle](https://newsroom.spotify.com/2023-03-08/smart-shuffle-new-life-spotify-playlists/) is complete.
## v1.2.24.x
- The right sidebar is no longer an experimental feature which can be toggled on/off, it is now permanent.
## v1.2.20.1218
- The last version of Spotify to work with macOS 10.13/10.14.
## v1.2.14.x
- The "[old UI](https://engineering.atspotify.com/2021/04/building-the-future-of-our-desktop-apps/)" has been removed completely. The "[new UI](https://newsroom.spotify.com/2023-06-20/spotify-desktop-experience-redesign-your-library-now-playing-views-customize/)" with left and right sidebars is now the default (and only) UI.
## v1.2.7.1277
- The first official/stable x64 build for Windows.
## v1.2.5.1006
- The last version of Spotify to work with Windows 7, 8 and 8.1.
## v1.1.89.862
- The last version of Spotify to work with OS X 10.11 and macOS 10.12.
## v1.1.86.857
- The first official/stable ARM64 build for Windows.
## v1.1.66.578
- The first official/stable ARM64 build for macOS.
## v1.1.59.710
- The oldest official Spotify client that still works (for now). As of May 2023, Spotify has disabled all prior client versions. OS X 10.10 and below are now cut off and can no longer use the official desktop client.

86
Troubleshooting.md Normal file

@@ -0,0 +1,86 @@
While SpotX-Bash is not responsible for Spotify or computer issues, having a troubleshooting guide can help reduce issues reported to the repo.
Use the following checklist when troubleshooting Spotify issues:
* [1. Close/Restart the Spotify app](#closerestart-the-spotify-app)
* [2. Reboot computer](#reboot-computer)
* [3A. Uninstall Spotify and app/cache data](#uninstall-spotify-and-appcache-data)
* [3B. Uninstall Spotify and app/cache data (automated script)](#uninstall-spotify-and-appcache-data-automated-script)
* [4. Change Spotify version](#change-spotify-version)
* [Official Spotify Support Communities and FAQ](#official-spotify-support-communities-and-faq)
## Close/Restart the Spotify app
Closing and restarting the Spotify app can sometimes help solve some issues.
This should always be attempted before trying anything else.
## Reboot computer
Reboot the computer before attempting to uninstall/reinstall Spotify or delete any files.
## Uninstall Spotify and app/cache data
If restarting Spotify and computer didn't resolve the error/issue, fully uninstalling then reinstalling Spotify should be attempted.
The same app version should also be used so that testing before and after the uninstall is consistent.
Unfortunately, Spotify for Linux and macOS does not have a built-in uninstaller.
The following details outline how to completely uninstall Spotify from the computer:
**For Linux:**
- Use the app/package manager or the uninstall method for the installation method used when installing Spotify
- Delete the app and cache data which, by default, is in the following directories:
`$HOME/.cache/spotify`
`$HOME/.config/spotify`
- Once all is deleted, reinstall Spotify (not `SpotX-Bash`), sign in and see if the error/issue persists
- If issue persists, check the [Official Spotify Support Communities and FAQ](#official-spotify-support-communities-and-faq)
- If the error/issue is gone, re-apply `SpotX-Bash`
- If the error/issue returns after re-applying `SpotX-Bash`, this may be a `SpotX-Bash` issue. Confirm your Spotify version is supported by `SpotX-Bash` and check [all previous issues](https://github.com/SpotX-Official/SpotX-Bash/issues?q=is%3Aissue) before submitting an issue.
**For macOS:**
- Delete the Spotify.app (by default, apps are located in /Applications)
- Delete the Spotify app and cache data which is in the following directories:
`$HOME/Library/Application Support/Spotify`
`$HOME/Library/Caches/com.spotify.client`
- Once all is deleted, reinstall Spotify (not `SpotX-Bash`), sign in and see if the error/issue persists
- If issue persists, check the [Official Spotify Support Communities and FAQ](#official-spotify-support-communities-and-faq)
- If the error/issue is gone, re-apply `SpotX-Bash`
- If the error/issue returns after re-applying `SpotX-Bash`, this may be a `SpotX-Bash` issue. Confirm your Spotify version is supported by `SpotX-Bash` and check [all previous issues](https://github.com/SpotX-Official/SpotX-Bash/issues?q=is%3Aissue) before submitting an issue.
## Uninstall Spotify and app/cache data (automated script)
If restarting Spotify and your computer did not resolve the issue, fully uninstalling then reinstalling Spotify should be attempted.
The same app version should also be used so that testing before and after the uninstall is consistent.
Unfortunately, Spotify for Linux and macOS does not have a built-in uninstaller but the following script will automatically find and delete the Spotify app + app/cache data.
In terminal run and follow any on-screen prompts if asked:
```
bash <(curl -sSL https://gist.github.com/jetfir3/f620e44fc246c1bed45ed040bbfa2d68/raw/uninstallify.sh)
```
- Once all is deleted, reinstall Spotify (not `SpotX-Bash`), sign in and see if the error/issue persists
- If issue persists, check the [Official Spotify Support Communities and FAQ](#official-spotify-support-communities-and-faq)
- If the error/issue is gone, re-apply `SpotX-Bash`
- If the error/issue returns after re-applying `SpotX-Bash`, this may be a `SpotX-Bash` issue. Confirm your Spotify version is supported by `SpotX-Bash` and check [all previous issues](https://github.com/SpotX-Official/SpotX-Bash/issues?q=is%3Aissue) before submitting an issue.
## Change Spotify version
If fully uninstalling and reinstalling Spotify did not remove the error/issue and it was not caused by `SpotX-Bash` then it's possible that the specific version of Spotify is responsible. Trying an older or newer version may help. Check the [Official Spotify Support Communities and FAQ](#official-spotify-support-communities-and-faq) to see if others have reported similar issues.
## Official Spotify Support Communities and FAQ
If the issue is not related to `SpotX-Bash`, use the official support pages to see if your issue has been reported or to report the issue yourself.
[Spotify Linux Desktop Support](https://community.spotify.com/t5/Desktop-Linux/bd-p/desktop_linux)
[Spotify macOS Desktop Support](https://community.spotify.com/t5/Desktop-Mac/bd-p/desktop_mac)
[Spotify 'Ongoing Issues' Support](https://community.spotify.com/t5/Ongoing-Issues/idb-p/ongoing_issues)
[Spotify 'Ongoing Issues' Under Investigation](https://community.spotify.com/t5/Ongoing-Issues/idb-p/ongoing_issues/status-key/Under_investigation)
[Spotify Help Search](https://community.spotify.com/t5/Help/ct-p/Help)
[Spotify FAQs](https://community.spotify.com/t5/FAQs/tkb-p/Spotify-Answers)