TBZify
Spotify desktop client management for macOS. Download and install TBZs. Block auto-updates. Uninstall everything.
Install / Use
/learn @jetfir3/TBZifyREADME
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 1will download/install latest known version- replace
1with full version number* to specify version - view options, examples and FAQ below for more <sub>
*as of May 2023, v1.1.58.820 and below is disabled by Spotify</sub>
<details> <summary><h3>Options:</h3></summary>| 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 |
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
</details>
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: 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.
Related Skills
node-connect
325.9kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
frontend-design
80.3kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
openai-whisper-api
325.9kTranscribe audio via OpenAI Audio Transcriptions API (Whisper).
commit-push-pr
80.3kCommit, push, and open a PR
