{"id":14006750,"url":"https://github.com/simonmeusel/MuteSpotifyAds","last_synced_at":"2025-07-24T00:32:06.076Z","repository":{"id":40313433,"uuid":"135333244","full_name":"simonmeusel/MuteSpotifyAds","owner":"simonmeusel","description":"A efficent MacOS application automatically silencing ads of the spotify desktop app","archived":true,"fork":false,"pushed_at":"2020-01-15T13:46:21.000Z","size":223,"stargazers_count":437,"open_issues_count":1,"forks_count":39,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-05-21T10:40:50.072Z","etag":null,"topics":["applescript","efficent","macos","spotify","spotify-desktop"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/simonmeusel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-05-29T17:52:20.000Z","updated_at":"2025-05-18T04:22:57.000Z","dependencies_parsed_at":"2022-08-18T02:00:44.194Z","dependency_job_id":null,"html_url":"https://github.com/simonmeusel/MuteSpotifyAds","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/simonmeusel/MuteSpotifyAds","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonmeusel%2FMuteSpotifyAds","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonmeusel%2FMuteSpotifyAds/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonmeusel%2FMuteSpotifyAds/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonmeusel%2FMuteSpotifyAds/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simonmeusel","download_url":"https://codeload.github.com/simonmeusel/MuteSpotifyAds/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonmeusel%2FMuteSpotifyAds/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266774758,"owners_count":23982246,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["applescript","efficent","macos","spotify","spotify-desktop"],"created_at":"2024-08-10T10:01:37.065Z","updated_at":"2025-07-24T00:32:05.843Z","avatar_url":"https://github.com/simonmeusel.png","language":"Swift","funding_links":[],"categories":["Swift"],"sub_categories":[],"readme":"#  MuteSpotifyAds\n\n[![size](https://img.shields.io/badge/size-10.6%20MB-brightgreen.svg)](https://github.com/simonmeusel/MuteSpotifyAds/releases)\n[![download size](https://img.shields.io/badge/download%20size-3.3%20MB-brightgreen.svg)](https://github.com/simonmeusel/MuteSpotifyAds/releases)\n[![macOS version support](https://img.shields.io/badge/macOS-10.12--10.15-brightgreen.svg)](https://github.com/simonmeusel/MuteSpotifyAds/releases)\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"https://i.imgur.com/n12KjSw.png\" height=\"200\"\u003e\u003c/p\u003e\n\nThis is a native and efficient macOS application automatically silencing ads on the Spotify desktop app.\n\nThis application is very CPU and power efficient, since it only checks for an ad when a new song gets played.\n\nThis application is not in any way affiliated with Spotify.\n\n## Features\n\n* Mute ads\n* Endless private session\n* Song log file\n* Restart spotify to skip ads\n* Auto-start Spotify with MuteSpotifyAds or run MuteSpotifyAds at startup\n\n## Usage\n\nInstead of running Spotify directly, start this application. It will automatically start Spotify. Furthermore it will mute any ads it sees. When you close Spotify this program will also terminate, and thus it no longer has any effect on your battery or CPU.\n\nAs of version `1.5.0` you can also enable a option to automatically skip ads, by restarting Spoitify. Therefore, click the `☀︎` in the status bar of your mac (at the top of your screen), and then click `◎ Restart to skip ads`.\n\n## Installation\n\nVia [homebrew](https://brew.sh/): `brew cask install mutespotifyads`\n\nManual installation:\n\n1. Download this application from the [releases page](https://github.com/simonmeusel/MuteSpotifyAds/releases/)\n2. Move it to your Applications folder\n3. Run it using **Right Click -\u003e Open**. You need to do this because [I don't pay Apple $99 every year](https://developer.apple.com/programs/).\n4. If you like the app, leave a [star](https://github.com/simonmeusel/MuteSpotifyAds/stargazers)!\n\nThis application is tested from macOS High Sierra (`10.13.5`) to and macOS Catalina (`10.15.1`) with Spotify `1.1.19.480.g7d17e3ce`.\n\nTo uninstall the application, you can simply trash `MuteSpotifyAds.app`.\n\n### Troubleshooting\n\nIf the Application does not work, follow the steps for enabling a endless private Spotify session.\n\n## Endless private Spotify session\n\nYou can also use this application to enforce a endless private session. **This requires you to grant this application additional priviledges**. To enable them, do the following:\n\n1. Go to `System Preferences` → `Security \u0026 Privacy` → `Privacy` tab → `Accessibility` → Enable the check mark next to this application. \n2. Go to `System Preferences` → `Security \u0026 Privacy` → `Privacy` tab → `Automation` → Enable the check marks next to this application (for `Spotify` and `System Events`).\n\nTo enable/disable the endless private session, click the `☀︎` in the status bar of your mac (at the top of your screen), and then click `∞ Private session`. This will ensure that the Spotify private session is enabled whenever the current song changes.\n\nThe state of the endless private session will be saved and restored on program restart.\n\nThis application enables the private session using [the following apple script](https://stackoverflow.com/a/51068836/6286431):\n\n```\ntell application \"System Events\" to tell process \"Spotify\"\ntell menu bar item 2 of menu bar 1 -- AppleScript indexes are 1-based\ntell menu item \"Private Session\" of menu 1\nset isChecked to value of attribute \"AXMenuItemMarkChar\" is \"✓\"\nif not isChecked then click it\nend tell\nend tell\nend tell\n```\n\n## How is it so efficient?\n\nWhenever the track changes, the following file will get modified by Spotify:\n\n```\n# When a song plays next\n~/Library/Application Support/Spotify/Users/($SPOTIFY_USER_NAME)-user/recently_played.bnk\n# When a ad plays next\n~/Library/Application Support/Spotify/Users/($SPOTIFY_USER_NAME)-user/ad-state-storage.bnk\n```\n\nThis application simply watches for a change at those files and then runs the following apple script, to detect ads:\n\n```\ntell application \"Spotify\" to (get spotify url of current track)\n```\n\nIf the Spotify URL starts with `spotify:ad`, the volume will be set to `0`. Once a normal track plays, your initial volume will be restored (if you haven't already enabled sound man).\n\nTo set and get the volume, the following apple script is used:\n\n```\ntell application \"Spotify\" to (get sound volume)\ntell application \"Spotify\" to set sound volume to ($VOLUME)\n```\n\nUsing those techniques, it uses only `0.4%` CPU when the track changes (rate: 5 seconds), and `0%` in idle. It has a energy impact of less than one tenth of Spotify when the track changes, and a energy impact of `0.0 - 0.1` in idle.\n\n## Contributing\n\nIf you want to contribute, feel free to do so. If you need help, just open a issue.\n\nYou can also contribute by adding support for another language. To do so, clone the repo, and then follow the instruction from [this image](https://cdn-images-1.medium.com/max/1791/1*K2hxQs-c2Q8aZkgjCl6q4Q.png). Then add the translations and open a pull request.\n\nCurrently supported languages are:\n\n* Chinese\n* English\n* German\n* Italian\n* Spanish\n* Turkish\n\n## Thanks\n\nThanks to [Carlo Federico Vescovo](https://github.com/cfvescovo) for the restart-spotify feature, the auto-start option and help with the documentation!\nThanks to [Artem Gordinsky](https://github.com/ArtemGordinsky/) and the [other contributors](https://github.com/ArtemGordinsky/Spotifree#thanks) of [Spotifree](https://github.com/ArtemGordinsky/Spotifree)!\nThanks to [vadian](https://stackoverflow.com/users/5044042/vadian) for the [help](https://stackoverflow.com/questions/51068410/osx-tick-menu-bar-checkbox/51068836#51068836)!\n\n## License\n\n[GNU General Public License v3.0](https://github.com/simonmeusel/MuteSpotifyAds/blob/master/LICENSE)\n\nCopyright (C) 2018 Simon Meusel\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimonmeusel%2FMuteSpotifyAds","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimonmeusel%2FMuteSpotifyAds","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimonmeusel%2FMuteSpotifyAds/lists"}