https://github.com/jetfir3/tbzify
Spotify desktop client management for macOS. Download and install TBZs. Block auto-updates. Uninstall everything.
https://github.com/jetfir3/tbzify
macos spotify spotify-desktop-client spotify-no-update uninstaller-script
Last synced: 6 months ago
JSON representation
Spotify desktop client management for macOS. Download and install TBZs. Block auto-updates. Uninstall everything.
- Host: GitHub
- URL: https://github.com/jetfir3/tbzify
- Owner: jetfir3
- License: mit
- Created: 2023-06-22T20:04:47.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-11-19T13:51:41.000Z (7 months ago)
- Last Synced: 2024-11-19T14:52:18.940Z (7 months ago)
- Topics: macos, spotify, spotify-desktop-client, spotify-no-update, uninstaller-script
- Language: Shell
- Homepage:
- Size: 338 KB
- Stars: 11
- Watchers: 2
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
TBZify
Download and install TBZs. Block auto-updates. Uninstall everything.
### Usage:
- Run the following command in Terminal:
```
bash <(curl -sSL https://raw.githubusercontent.com/jetfir3/TBZify/main/tbzify.sh) -v 1
```
- script can instead be downloaded/run locally
- `-v 1` will download/install latest known version
- replace `1` with full version number* to specify version
- view options, examples and FAQ below for more
*as of May 2023, v1.1.58.820 and below is disabled by Spotify
Options:
| Option | Description |
| --- | --- |
| `-a [path]` | set custom path to Spotify.app |
| `-b` | block Spotify auto-updates (--blockupdates) |
| `-d` | download only, no install (--noinstall) |
| `--datawipe` | delete app data only |
| `-h` | print options (--help) |
| `-p [path]` | set archive/download path |
| `-s` | save archive after script finishes (--save) |
| `-u [URL]` | URL of archive to download/install |
| `--uninstall` | uninstall Spotify, including app data |
| `-v [version]` | archive version to download/install |
Examples:
**Download TBZ, install client, delete TBZ**
```
./tbzify.sh -v 1.2.13.661
```
**Download TBZ (via URL), install client, delete TBZ**
```
./tbzify.sh -u https://exampleurl.com/file.tbz
```
**Install local TBZ archive**
```
./tbzify.sh -p /path/to/file.tbz
```
**Delete Spotify app data**
```
./tbzify.sh --datawipe
```
**Uninstall Spotify, including app data**
```
./tbzify.sh --uninstall
```
**Delete app data, download to `Desktop`, install to `Downloads`, block updates, save TBZ**
```
./tbzify.sh --datawipe -v 1.2.13.661 -p $HOME/Desktop -a $HOME/Downloads -bs
```
### FAQ:
**Q:** What is a TBZ file?
**A:** TBZ is a Bzip2 compressed TAR file. Spotify packages their macOS desktop client updates in this format.
**Q:** Can't I just download the app installer on the Spotify download page?
**A:** Absolutely, but the download page only provides the most recent stable version. "Latest isn't always the greatest" and new builds can sometimes have bugs, change/remove features, etc. Installing a different/specific version may then be preferred.
**Q:** Why is a script needed to download or install a TBZ file?
**A:** It's not, but handling the archive is not as simple as the usual macOS installation methods.
**Q:** How can I manually download and install a TBZ instead?
**A:** Download a TBZ archive, delete your current `Spotify.app/Contents/` directory (if a previous Spotify.app doesn't exist, create a Spotify.app directory/folder), then extract the contents of the TBZ archive into your `Spotify.app` directory. This can all be done via GUI|browser/Finder or CLI|Terminal.
**Q:** Where can I find TBZ URLs?
**A:** Try [here](https://docs.google.com/spreadsheets/d/1wztO1L4zvNykBRw7X4jxP8pvo11oQjT0O5DvZ_-S4Ok/edit#gid=1071764554)
**Q:** Why am I getting an "Invalid version/unofficial source detected." error?
**A:** This repo only supports downloading from Spotify's official CDN, anything else may fail. If using `-v [version]`, availability is soley based on known versions in examples.txt. If you have the URL of a version not already listed you can use it with `-u [URL]`.
**Q:** Why isn't Spotify working correctly after upgrading/downgrading?
**A:** There may be conflicts with Spotify app data leftover from a previous install. Use `--datawipe` to delete Spotify's app data. Using `--datawipe` paired with `-u [URL]` or `-v [version]` would delete app data and install the specified app version in a single run. Issues related to Spotify bugs and/or computer/OS issues fall outside the scope of this repo but may be solved by installing a different Spotify app version and/or wiping app data.
***