Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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: 29 days ago
JSON representation

SpotX Mac and Linux adblocker for the Spotify desktop client, in Bash

Awesome Lists containing this project

README

        






***

Adblock for the Spotify desktop client on Linux & macOS



Latest supported version: 1.2.48.405.gf2c48e6f

### 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)