Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/SpotX-Official/SpotX-Bash
SpotX Mac and Linux adblocker for the Spotify desktop client, in Bash
https://github.com/SpotX-Official/SpotX-Bash
adblock adblocker linux mac macos spotify spotify-ad-blocker spotify-ad-free spotify-adblock spotify-adblocker spotify-ads spotify-ads-remover spotify-linux spotify-linux-client spotify-mac spotify-macos spotify-mod spotify-no-ads spotify-no-update
Last synced: about 1 month ago
JSON representation
SpotX Mac and Linux adblocker for the Spotify desktop client, in Bash
- Host: GitHub
- URL: https://github.com/SpotX-Official/SpotX-Bash
- Owner: SpotX-Official
- License: mit
- Created: 2023-01-30T15:51:05.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-06-23T21:13:07.000Z (3 months ago)
- Last Synced: 2024-06-29T00:15:34.090Z (2 months ago)
- Topics: adblock, adblocker, linux, mac, macos, spotify, spotify-ad-blocker, spotify-ad-free, spotify-adblock, spotify-adblocker, spotify-ads, spotify-ads-remover, spotify-linux, spotify-linux-client, spotify-mac, spotify-macos, spotify-mod, spotify-no-ads, spotify-no-update
- Language: Shell
- Homepage:
- Size: 360 KB
- Stars: 1,652
- Watchers: 24
- Forks: 57
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
***
Adblock for the Spotify desktop client on Linux & macOS
Latest supported version: 1.2.43.420.gc7b23f70
### Features:
- Block all audio, banner & video ads
- Block logging
- Enable [developer mode](https://github.com/SpotX-Official/SpotX-Bash/wiki/SpotX%E2%80%90Bash-FAQ#what-is-developer-mode)
- Enable experimental features
- Hide audiobooks, episodes & podcasts on home screen
- Block automatic updates (macOS)
- Install supported desktop client versions (macOS)
- Install latest desktop client on APT-based distros (Linux)
- Supports all Linux distros and OS X/macOS 10.11+
### Usage:
- Run the following command in terminal:
```
bash <(curl -sSL https://spotx-official.github.io/run.sh)
```
- By default...
- all supported experimental features are enabled
- free-tier user patches are applied, paid-premium users should use `-p` / `--premium` flag
- macOS client auto-updates are NOT disabled, block auto-updates with `-B` / `--blockupdates` flag
- View additional flags/options and examples in the `Options` section below
- For more information, see the [FAQ](https://github.com/SpotX-Official/SpotX-Bash/wiki/SpotX%E2%80%90Bash-FAQ)
### Options:
Click to expand!
| Option | Description |
| --- | --- |
| `-B` | block client auto-updates [macOS] |
| `-c` | clear client app cache |
| `-d` | enable [developer mode](https://github.com/SpotX-Official/SpotX-Bash/wiki/SpotX%E2%80%90Bash-FAQ#what-is-developer-mode) |
| `-e` | exclude all experimental features |
| `-f` | force SpotX-Bash to run |
| `-h` | hide non-music on home screen |
| `--help` | print options |
| `-i` | enable interactive mode |
| `--installdeb` | install latest client deb pkg on APT-based distros [Linux] |
| `--installmac` | install latest supported client [macOS] |
| `-l` | [set lyrics background color to black](https://github.com/SpotX-Official/SpotX-Bash/issues/20#issuecomment-1762040019) |
| `--nocolor` | remove colors from SpotX-Bash output |
| `-o` | use [old home screen UI](https://github.com/SpotX-Official/SpotX-Bash/wiki/SpotX%E2%80%90Bash-FAQ#what-is-the-old-and-new-ui) |
| `-p` | [paid premium-tier subscriber](https://github.com/SpotX-Official/SpotX-Bash/wiki/SpotX%E2%80%90Bash-FAQ#can-spotx-bash-be-used-with-a-paid-premium-account) |
| `-P ` | set path to client |
| `-S` | skip [codesigning](https://github.com/SpotX-Official/SpotX-Bash/discussions/3) [macOS] |
| `--stable` | use with '--installdeb' for stable branch [Linux] |
| `--uninstall` | uninstall SpotX-Bash |
| `-v` | print SpotX-Bash version |
| `-V ` | install client version [macOS] |
**Examples:**
**Run SpotX-Bash, clear app cache, enable dev mode, hide non-music categories**
```
bash <(curl -sSL https://spotx-official.github.io/run.sh) -cdh
```
**Run SpotX-Bash, enable interactive mode, set custom path to client**
```
bash <(curl -sSL https://spotx-official.github.io/run.sh) -i -P $HOME/Downloads/
```
**Run SpotX-Bash, set paid premium-tier subscriber**
```
bash <(curl -sSL https://spotx-official.github.io/run.sh) -p
```
**Run SpotX-Bash, install latest testing branch client version (Linux)**
```
bash <(curl -sSL https://spotx-official.github.io/run.sh) --installdeb
```
**Run SpotX-Bash, block auto-updates, install latest supported client version (macOS)**
```
bash <(curl -sSL https://spotx-official.github.io/run.sh) -B --installmac
```
### Thanks:
- [amd64fox](https://github.com/amd64fox/) of [SpotX](https://github.com/SpotX-Official/SpotX)