SAMP

SAMP (Spotify Ad Muter Panel) is a lightweight, open-source Windows application designed to automatically manage Spotify's volume based on whether it is playing music or an audio advertisement. Built with Python and PyQt6, SAMP operates entirely on your local machine to provide a seamless listening experience without requiring manual volume adjustments.

KEY FEATURES

• Independent Volume Controls: Set separate target volume levels for songs and advertisements (for example, automatically lower or mute ads to 0 percent while preserving your preferred music volume).

• Master System Volume: Adjust the main Windows master audio output directly from the application's main interface.

• Automatic Playback Detection: Uses the native Windows System Media Transport Controls API (GSMTC/SMTC) to distinguish music tracks from unskippable audio ads.

• Instant Volume Switching: Leverages the Windows Audio Session API (WASAPI) via pycaw to seamlessly transition volume levels the moment playback changes.

• Start with Spotify Automation: Optional background watcher task that automatically launches SAMP whenever Spotify is opened on your system.

• Custom Themes and Multi-Language: Built-in Dark, Light, and Forest visual themes, along with runtime switching between English, Spanish, German, and French.

• Single-Instance Protection: Enforces single-instance execution to avoid duplicate background processes and brings existing windows to focus.

• Portable and Installer Options: Available as both a guided executable setup built with Inno Setup and a portable standalone ZIP package that runs without administrative rights.

HOW IT WORKS AND LEGAL COMPLIANCE

SAMP does not function as an ad blocker. It does not modify Spotify binary files, block network requests, alter client code, or bypass technical protection measures. Instead, it acts purely as an external audio manager:

1. It queries the public Windows operating system media transport interface (SMTC) to observe playback status.
2. Upon state transitions, it adjusts the volume of the Spotify.exe audio session via standard Windows WASAPI output controls.

PRIVACY AND LICENSE

• 100 Percent Offline and Telemetry-Free: SAMP contains no analytics, collects zero user data, and makes no external network calls; all processing is local.
• Free and Open Source: SAMP is released under the GNU General Public License v3 (GPLv3).

SYSTEM REQUIREMENTS

• Operating System: Windows 10 / 11 (64-bit, build 17763 or higher).
• Storage: ~54 MB available (60 MB recommended)
• Spotify: Official desktop application installed and running.