{"id":13467470,"url":"https://github.com/abba23/spotify-adblock","last_synced_at":"2025-03-26T02:31:26.794Z","repository":{"id":37014448,"uuid":"362904462","full_name":"abba23/spotify-adblock","owner":"abba23","description":"Adblocker for Spotify","archived":false,"fork":false,"pushed_at":"2024-09-15T09:11:27.000Z","size":56,"stargazers_count":1860,"open_issues_count":12,"forks_count":93,"subscribers_count":20,"default_branch":"main","last_synced_at":"2024-10-29T21:54:12.867Z","etag":null,"topics":["adblock","linux","spotify"],"latest_commit_sha":null,"homepage":"https://github.com/abba23/spotify-adblock","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/abba23.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-29T18:01:51.000Z","updated_at":"2024-10-29T18:25:23.000Z","dependencies_parsed_at":"2024-10-29T20:50:41.330Z","dependency_job_id":null,"html_url":"https://github.com/abba23/spotify-adblock","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abba23%2Fspotify-adblock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abba23%2Fspotify-adblock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abba23%2Fspotify-adblock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abba23%2Fspotify-adblock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/abba23","download_url":"https://codeload.github.com/abba23/spotify-adblock/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245576529,"owners_count":20638125,"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","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":["adblock","linux","spotify"],"created_at":"2024-07-31T15:00:56.953Z","updated_at":"2025-03-26T02:31:26.771Z","avatar_url":"https://github.com/abba23.png","language":"Rust","funding_links":[],"categories":["Rust"],"sub_categories":[],"readme":"# spotify-adblock\nSpotify adblocker for Linux (macOS untested) that works by wrapping `getaddrinfo` and `cef_urlrequest_create`. It blocks requests to domains that are not on the allowlist, as well as URLs that are on the denylist.\n\n### Notes\n* This **does not** work with the snap Spotify package.\n* This **might not** work with the Flatpak Spotify package, depending on your system's shared libraries' versions.\n* On Debian-based distributions (e.g. Ubuntu), the Debian Spotify package can be installed by following the instructions at the bottom of [this page](https://www.spotify.com/us/download/linux/). *(recommended)*\n\n## Build\nPrerequisites:\n* Git\n* Make\n* Rust\n* [Cargo](https://doc.rust-lang.org/cargo/)\n\n```bash\n$ git clone https://github.com/abba23/spotify-adblock.git\n$ cd spotify-adblock\n$ make\n```\n\n## Install\n```bash\n$ sudo make install\n```\n\n#### Flatpak\n```bash\n$ mkdir -p ~/.spotify-adblock \u0026\u0026 cp target/release/libspotifyadblock.so ~/.spotify-adblock/spotify-adblock.so\n$ mkdir -p ~/.var/app/com.spotify.Client/config/spotify-adblock \u0026\u0026 cp config.toml ~/.var/app/com.spotify.Client/config/spotify-adblock\n$ flatpak override --user --filesystem=\"~/.spotify-adblock/spotify-adblock.so\" --filesystem=\"~/.config/spotify-adblock/config.toml\" com.spotify.Client\n```\n\n## Usage\n### Command-line\n```bash\n$ LD_PRELOAD=/usr/local/lib/spotify-adblock.so spotify\n```\n\n#### Flatpak\n```bash\n$ flatpak run --command=sh com.spotify.Client -c 'eval \"$(sed s#LD_PRELOAD=#LD_PRELOAD=$HOME/.spotify-adblock/spotify-adblock.so:#g /app/bin/spotify)\"'\n```\n\n### Desktop file\nYou can integrate it with your desktop environment by creating a `.desktop` file (e.g. `spotify-adblock.desktop`) in `~/.local/share/applications`. This lets you easily run it from an application launcher without opening a terminal.\n\nExamples:\n\n\u003cdetails\u003e \n  \u003csummary\u003eDebian Package\u003c/summary\u003e\n  \u003cp\u003e\n\n```\n[Desktop Entry]\nType=Application\nName=Spotify (adblock)\nGenericName=Music Player\nIcon=spotify-client\nTryExec=spotify\nExec=env LD_PRELOAD=/usr/local/lib/spotify-adblock.so spotify %U\nTerminal=false\nMimeType=x-scheme-handler/spotify;\nCategories=Audio;Music;Player;AudioVideo;\nStartupWMClass=spotify\n```\n  \u003c/p\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eFlatpak\u003c/summary\u003e\n  \u003cp\u003e\n\n```\n[Desktop Entry]\nType=Application\nName=Spotify (adblock)\nGenericName=Music Player\nIcon=com.spotify.Client\nExec=flatpak run --file-forwarding --command=sh com.spotify.Client -c 'eval \"$(sed s#LD_PRELOAD=#LD_PRELOAD=$HOME/.spotify-adblock/spotify-adblock.so:#g /app/bin/spotify)\"' @@u %U @@\nTerminal=false\nMimeType=x-scheme-handler/spotify;\nCategories=Audio;Music;Player;AudioVideo;\nStartupWMClass=spotify\n```\n  \u003c/p\u003e\n\u003c/details\u003e\n\n## Uninstall\n```bash\n$ sudo make uninstall\n```\n\n#### Flatpak\n```bash\n$ rm -r ~/.spotify-adblock ~/.config/spotify-adblock\n$ flatpak override --user --reset com.spotify.Client\n```\n\n## Configuration\nThe allowlist and denylist can be configured in a config file located at (in descending order of precedence):\n* `config.toml` in the working directory\n* `$XDG_CONFIG_HOME/spotify-adblock/config.toml`\n* `~/.config/spotify-adblock/config.toml`\n* `/etc/spotify-adblock/config.toml` *(default)*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabba23%2Fspotify-adblock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabba23%2Fspotify-adblock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabba23%2Fspotify-adblock/lists"}