A multi-featured adblocker for the Spotify macOS application.
Last updated: 20 January 2023
Last tested version: 1.2.3.1115
We need collaborators.
- We are running short of people who can collaborate and maintain this project. If you are good with bash scripting, please create an issue here or contact Red.#1111 in discord.
Features:
- Blocks all banner/video/audio ads within the app
- Blocks logging (Sentry, etc)
- Unlocks the skip function for any track
- Blocks Spotify automatic updates (optional)
- Enables experimental features (optional)
- Hides podcasts, episodes and audiobooks on Home Screen (optional)
Installation/Update:
- Close Spotify completely.
- Run The following command in Terminal:
bash <(curl -sSL https://raw.githubusercontent.com/SpotX-CLI/SpotX-Mac/main/install.sh)
Optional Install Arguments:
-c Clear app cache -- use if UI-related patches aren't working
-e Experimental features -- enables experimental features
-E Exclude feature -- disables specified feature(s) [currently disabled]
-f Force patch -- forces re-patching if backup detected
-h Hide podcasts, episodes and audiobooks on home screen
-o Old UI -- skips forced 'new UI' patch
-p Premium subscription setup -- use if premium subscriber
-P Path to Spotify.app -- set custom Spotify app path
-u Update block -- blocks automatic updates
Use any combination of flags.
The following example clears app cache, adds experimental features, leaves new UI enabled and blocks updates:
bash <(curl -sSL https://raw.githubusercontent.com/SpotX-CLI/SpotX-Mac/main/install.sh) -ceu
Uninstall:
- Close Spotify completely.
- Run The following command in Terminal:
bash <(curl -sSL https://raw.githubusercontent.com/SpotX-CLI/SpotX-Mac/main/uninstall.sh)
or
- Reinstall Spotify
Notes:
- Audio/video ads during Podcast playback are currently NOT blocked with SpotX.
- Spicetify users: When using SpotX-Mac + Spicetify, the current script requires running SpotX first.
DISCLAIMER
- Ad blocking is the main concern of this repo. Any other feature provided by SpotX-Mac or consequence of using those features will be the sole responsibility of the user, not BlockTheSpot/SpotX/SpotX-CLI/SpotX-Mac.
Credits
- Thanks to SpotX - amd64fox.
- Thanks to @jetfir3 for the extended contribution