spotx-official/spotx-bash

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

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 17 minutes ago
Added to GitGenius on September 11th, 2026
Created on January 30th, 2023
Open Issues & Pull Requests: 3 (+0)
GitHub issues: Enabled
Number of forks: 227
Total Stargazers: 6,048 (+0)
Total Subscribers: 44 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 4.5 hours
Mean response time: 31.8 hours
90th percentile: 28.0 hours
Tracked items: 68

How this project is maintained

Around half of the issues opened in the past year never receive a reply. Only 19% of issues opened in the past year have been closed. Three people close 80% of everything that gets resolved.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 3
New in 7 days: 1
Closed in 7 days: 0
Avg open age: 27 days
Stale 30+ days: 0
Stale 90+ days: 0

Recent activity

Opened in 7 days: 1
Closed in 7 days: 0
Comments in 7 days: 0
Events in 7 days: 0

Top labels

  • fixed (7)
  • read faq (4)
  • duplicate (2)
  • invalid (2)
  • User Error (1)
  • bug (1)
  • official client bug (1)

Most active issues this week

Detailed Description

SpotX Bash is an ad-blocking tool for the Spotify desktop client on Linux and macOS.

The tool modifies the Spotify desktop client to remove advertisements and related tracking. It works by patching the client installation to block audio, banner, and video ads while also disabling logging, enabling developer mode, and optionally hiding podcasts and audiobooks from the home screen. On macOS, it can prevent automatic client updates. The tool supports installation of the latest desktop client versions on macOS and APT-based Linux distributions, and works across all Linux distributions and macOS versions from 10.11 onward.

Developers running Spotify on Linux or macOS who want ad-free listening without a premium subscription should consider this tool. It applies free-tier user patches by default, though premium subscribers can use a flag to skip those modifications. The tool includes special handling for Snap-based Spotify installations through a separate helper script, and NixOS users are directed to a dedicated NixOS package instead. The README does not compare this tool to alternatives.

The project maintains active engagement with its community through a dedicated Telegram channel. Development appears focused on compatibility across diverse Linux distributions and macOS versions, with specific accommodations for package managers like Snap and Nix that require non-standard approaches. The tool includes comprehensive documentation in a FAQ addressing shell compatibility and usage variations.