Skip to content

🛡️ A set of modular, highly‑optimized, and efficient filter lists that block ads, trackers, malware, phishing, and intrusive web clutter - from cookie banners to fake links. 👾

License

Notifications You must be signed in to change notification settings

the-advoid/ad-void

Repository files navigation

AdVoid icon - privacy-first ad-block filter list by Igor Dimitrijević (@igorskyflyer), trusted by hundreds of thousands

AdVoid

Super‑Fast Updates • More Complete Blocking • Always‑Fresh Protection • Trusted by Thousands Daily

🛡️ A set of modular, highly‑optimized, and efficient filter lists that block ads, trackers, malware, phishing, and intrusive web clutter - from cookie banners to fake links. 👾


AdVoid launch badge - efficient ad-block filter list by Igor Dimitrijević (@igorskyflyer), live since Feb 2022 AdVoid.Core version badge - by Igor Dimitrijević (@igorskyflyer), optimized for fast ad-blocking AdVoid.Core file size badge - lightweight ad-block filter by Igor Dimitrijević (@igorskyflyer)
AdVoid closed PRs badge - active development by Igor Dimitrijević (@igorskyflyer), community-driven AdVoid commit activity badge - frequent updates by Igor Dimitrijević (@igorskyflyer), always-fresh protection AdVoid closed issues badge - responsive maintenance by Igor Dimitrijević (@igorskyflyer)
AdVoid CDN badge - fast, reliable ad-block filter list by Igor Dimitrijević (@igorskyflyer), hosted on jsDelivr for global privacy protection AdVoid last updated badge - latest commit by Igor Dimitrijević (@igorskyflyer), filter list always evolving AdVoid license badge - GPLv3 licensed by Igor Dimitrijević (@igorskyflyer), open-source ad-block innovation

💕 Supported by AdGuard since December 19, 2022. 🥳


📃 Table of Contents



🤖 Features

  • 🚫 Blocks ads, trackers, malware and phishing
  • 🍪 Removes cookie banners and consent popups
  • 📦 Eliminates fake download links and search results
  • 📣 Silences push notifications and intrusive modals
  • 📰 Hides news widgets, post widgets and comments
  • 🎯 Skips countdowns and bypasses delays
  • 📺 Disables Chromecast prompts and popup chats
  • 🛠 Stops service workers, PWA banners and webmanifests
  • 🗺 Strips JavaScript and CSS maps
  • 🕹 Removes SWF objects and site reporters

ℹ️ Quickstart

🆕 New to ad‑blocking? Read the QUICKSTART first. 😉


🕵🏼 Usage

Get all AdVoid filter lists in one bundle as AdVoid.Full or choose only modules that you need.


🛡️ Note that some AdVoid rules require trust to activate.

See Filter Trust for more details - benefits and dangers that it brings.


🐦‍🔥 Modules

Modules are the four core AdVoid filter lists. Designed for layered protection: block ads, trackers, malware, and annoyances across web, DNS, and browser surfaces.


🛡️ AdVoid.Full

The Complete Protection

Includes all modules and add-ons, except experimental rules and standalone scriptlets. Blocks major ad-servers, trackers, malware, fake download links, cookie-consent banners, popups, modals, push notifications, survey, newsletter and subscribe popups, sharing, Google Chromecast, popup chats, post widgets, like widgets, news widgets, JavaScript and CSS maps, PWA install banners, SWF objects.

✨ If you subscribe to this filter list, you do not need any of the other filter lists below it.


Subscribe via GitHub to get instant updates, either by clicking the Subscribe button below or copying the URL below and pasting it into your ad-blocker.

Subscribe button - add AdVoid.Full filter list by Igor Dimitrijević (@igorskyflyer) for complete ad-blocking

https://raw.githubusercontent.com/the-advoid/ad-void/main/AdVoid.Full.txt

Subscribe via the fallback CDN jsDelivr to get delayed updates (up to 12h), either by clicking the Subscribe button below or copying the URL below and pasting it into your ad-blocker.

Subscribe button - add AdVoid.Full filter list by Igor Dimitrijević (@igorskyflyer) for complete ad-blocking

https://cdn.jsdelivr.net/gh/the-advoid/ad-void@main/AdVoid.Full.txt

📦 AdVoid.Core

The Core Protection Module

Blocks major ad-servers, trackers, malware, fake download links, cuts-down timer executions.


Subscribe via GitHub to get instant updates, either by clicking the Subscribe button below or copying the URL below and pasting it into your ad-blocker.

Subscribe button - install AdVoid.Core filter list by Igor Dimitrijević (@igorskyflyer) for essential protection

https://raw.githubusercontent.com/the-advoid/ad-void/main/AdVoid.Core.txt

Subscribe via the fallback CDN jsDelivr to get delayed updates (up to 12h), either by clicking the Subscribe button below or copying the URL below and pasting it into your ad-blocker.

Subscribe button - install AdVoid.Core filter list by Igor Dimitrijević (@igorskyflyer) for essential protection

https://cdn.jsdelivr.net/gh/the-advoid/ad-void@main/AdVoid.Core.txt

🌱 AdVoid.Lite

The Lite Protection Module

Blocks the most common ad servers, trackers, and malware - delivering fast, minimal protection with low overhead. Perfect for mobile, low‑power devices, or users who want a simple baseline shield. Refrains from using advanced and CPU-heavy rules.

Lighter by ~35% than AdVoid.Full and by ~12% than AdVoid.Core.


Subscribe via GitHub to get instant updates, either by clicking the Subscribe button below or copying the URL below and pasting it into your ad-blocker.

Subscribe button - install AdVoid.Lite filter list by Igor Dimitrijević (@igorskyflyer) for lightweight protection

https://raw.githubusercontent.com/the-advoid/ad-void/main/AdVoid.Lite.txt

Subscribe via the fallback CDN jsDelivr to get delayed updates (up to 12h), either by clicking the Subscribe button below or copying the URL below and pasting it into your ad-blocker.

Subscribe button - install AdVoid.Lite filter list by Igor Dimitrijević (@igorskyflyer) for lightweight protection

https://cdn.jsdelivr.net/gh/the-advoid/ad-void@main/AdVoid.Lite.txt

🌐 AdVoid.DNS

The DNS-level Module

Blocks domains before requests reach your browser: ads, trackers, telemetry, malware, and known nuisances. Lightweight, system-wide protection. Suitable for system-wide ad-blockers.


Subscribe via GitHub to get instant updates, either by clicking the Subscribe button below or copying the URL below and pasting it into your ad-blocker.

Subscribe button - enable AdVoid.DNS filter list by Igor Dimitrijević (@igorskyflyer) for system-wide blocking

https://raw.githubusercontent.com/the-advoid/ad-void/main/AdVoid.DNS.txt

Subscribe via the fallback CDN jsDelivr to get delayed updates (up to 12h), either by clicking the Subscribe button below or copying the URL below and pasting it into your ad-blocker.

Subscribe button - enable AdVoid.DNS filter list by Igor Dimitrijević (@igorskyflyer) for system-wide blocking

https://cdn.jsdelivr.net/gh/the-advoid/ad-void@main/AdVoid.DNS.txt


🪼 Add-ons

For additional privacy, faster browsing experience and less tracking these AdVoid add-ons are available.


😒 AdVoid.Addon.NoAnnoyances

The No Annoyances Add-on

Blocks site annoyances: cookie-consent banners, popups, modals, push notifications, survey, newsletter and subscribe popups, rating dialogs, skips countdowns, etc.


Subscribe via GitHub to get instant updates, either by clicking the Subscribe button below or copying the URL below and pasting it into your ad-blocker.

Subscribe button - activate AdVoid.Addon.NoAnnoyances by Igor Dimitrijević (@igorskyflyer), block popups & modals

https://raw.githubusercontent.com/the-advoid/ad-void/main/add-ons/AdVoid.Addon.NoAnnoyances.txt

Subscribe via the fallback CDN jsDelivr to get delayed updates (up to 12h), either by clicking the Subscribe button below or copying the URL below and pasting it into your ad-blocker.

Subscribe button - activate AdVoid.Addon.NoAnnoyances by Igor Dimitrijević (@igorskyflyer), block popups & modals

https://cdn.jsdelivr.net/gh/the-advoid/ad-void@main/add-ons/AdVoid.Addon.NoAnnoyances.txt

💬 AdVoid.Addon.NoExternals

The No Externals Add-on

Blocks external features: sharing, Google Chromecast, popup chats, post widgets, like widgets, etc.


Subscribe via GitHub to get instant updates, either by clicking the Subscribe button below or copying the URL below and pasting it into your ad-blocker.

Subscribe button - use AdVoid.Addon.NoExternals by Igor Dimitrijević (@igorskyflyer), block widgets & chats

https://raw.githubusercontent.com/the-advoid/ad-void/main/add-ons/AdVoid.Addon.NoExternals.txt

Subscribe via the fallback CDN jsDelivr to get delayed updates (up to 12h), either by clicking the Subscribe button below or copying the URL below and pasting it into your ad-blocker.

Subscribe button - use AdVoid.Addon.NoExternals by Igor Dimitrijević (@igorskyflyer), block widgets & chats

https://cdn.jsdelivr.net/gh/the-advoid/ad-void@main/add-ons/AdVoid.Addon.NoExternals.txt

🦄 AdVoid.Addon.NoExtras

The No Extras Add-on

Blocks non-essential resources: news widgets, JavaScript and CSS maps, PWA install banners, SWF objects, etc.


Subscribe via GitHub to get instant updates, either by clicking the Subscribe button below or copying the URL below and pasting it into your ad-blocker.

Subscribe button - apply AdVoid.Addon.NoExtras by Igor Dimitrijević (@igorskyflyer), block JS maps & PWA banners

https://raw.githubusercontent.com/the-advoid/ad-void/main/add-ons/AdVoid.Addon.NoExtras.txt

Subscribe via the fallback CDN jsDelivr to get delayed updates (up to 12h), either by clicking the Subscribe button below or copying the URL below and pasting it into your ad-blocker.

Subscribe button - apply AdVoid.Addon.NoExtras by Igor Dimitrijević (@igorskyflyer), block JS maps & PWA banners

https://cdn.jsdelivr.net/gh/the-advoid/ad-void@main/add-ons/AdVoid.Addon.NoExtras.txt

🧪 AdVoid.Addon.Experiments

The Experimental Add-on

Unstable and experimental filter list, for testing purposes only.

‼️ It may break certain sites.


Subscribe via GitHub to get instant updates, either by clicking the Subscribe button below or copying the URL below and pasting it into your ad-blocker.

Subscribe button - test AdVoid.Addon.Experiments by Igor Dimitrijević (@igorskyflyer), cutting-edge ad-block rules

https://raw.githubusercontent.com/the-advoid/ad-void/main/add-ons/AdVoid.Addon.Experiments.txt

Subscribe via the fallback CDN jsDelivr to get delayed updates (up to 12h), either by clicking the Subscribe button below or copying the URL below and pasting it into your ad-blocker.

Subscribe button - test AdVoid.Addon.Experiments by Igor Dimitrijević (@igorskyflyer), cutting-edge ad-block rules

https://cdn.jsdelivr.net/gh/the-advoid/ad-void@main/add-ons/AdVoid.Addon.Experiments.txt


⚡ Scriptlets

🛑 DANGER

If you are not aware what scriptlets are beforehand, it's recommended not to use them.

Many times, basic ad-blocking is not enough and that's where scriptlets come in. Scriptlets are a superpower inside ad-blocking world. But… with great power, comes great responsibility!
Scriptlets are chunks of JavaScript code that run on a particular site and can change its behavior majorly, e.g.: cut down waiting time, disable popup windows, prevent aggressive ads and many things more!

💡 Remember to add scriptlets only from trusted source.

AdVoid being a complete ad-blocking solution, also provides scriptlets listed below.


🥷🏼 AdVoid.Scriptlets.AntiAntiAdBlock

Anti-adblock Scriptlet

Infiltrates and then destroys common anti-adblock techniques.

‼️ It may break certain sites.


Subscribe via GitHub to get instant updates, either by clicking the Subscribe button below or copying the URL below and pasting it into your ad-blocker.

Subscribe button - enable AdVoid.Scriptlets.AntiAntiAdBlock by Igor Dimitrijević (@igorskyflyer), bypass anti-adblock scripts with precision

https://raw.githubusercontent.com/the-advoid/ad-void/main/scriptlets/AdVoid.Scriptlets.AntiAntiAdBlock.txt

Subscribe via the fallback CDN jsDelivr to get delayed updates (up to 12h), either by clicking the Subscribe button below or copying the URL below and pasting it into your ad-blocker.

Subscribe button - enable AdVoid.Scriptlets.AntiAntiAdBlock by Igor Dimitrijević (@igorskyflyer), bypass anti-adblock scripts with precision

https://cdn.jsdelivr.net/gh/the-advoid/ad-void@main/scriptlets/AdVoid.Scriptlets.AntiAntiAdBlock.txt


🛡️ Filter Trust

While the majority of AdVoid's rules manage to block more than enough ads for most users, some rules in AdVoid only activate if the ad-blocker marks the used list(s) as trusted.

This will unlock advanced techniques like:

  • Setting cookies via scriptlets (trusted-set-cookie)
  • Rewriting JavaScript on the fly (replace=...)
  • Redirecting scripts with custom logic (redirect-rule=...)

These are powerful tools that go beyond cosmetic hiding and ad-blocking, they alter a site's behavior directly. To enable them, users must manually mark AdVoid filter list(s) as trusted in their ad-blocker settings.

Many ad-blockers show an error when trusted rules are encountered (shown below), thus, signaling the list needs to be trusted to achieve its full potential.


See the Disclaimer as well.

Ad-blocker error message showing untrusted filter list warning in uBlock Origin
Figure 1. Errors caused by untrusted rules in uBlock Origin
AdVoid's advanced rules blocked until the list is marked as trusted


🎠 Legacy

As AdVoid continues to improve, certain rules will get deprecated and removed from main filter lists and transferred to the Legacy filter lists, see Legacy README for more information.


📚 Case Study

AdVoid was started as a personal project in January, 2022 then made public mid February of the same year. At first it was very easy to add new rules or modify existing ones since there were only a few rules to manage. As the filter list continued to grow, it diverged into distinct, smaller lists known as modules and add-ons - for easier maintenance.

Even with all the rules-splitting, maintenance was cumbersome. Since Aug 14 2023, AdVoid has been powered by ADBT - a language that defines template files and provides ways of writing reusable, component-like ad-block filter files and its compiler Aria that substantially increase productivity and cut down the time needed for maintaining these filter lists, which means more frequent updates and delivery on a daily basis.


🐛 Divergence Pt. 1

The modules were:

  • AdVoid.Core - core functionality (ad-blocking, URL + cosmetic)
  • AdVoid.DNS - DNS-blocking (URL only)
  • AdVoid.Full - full content blocking (core functionality + add-ons)

🐛 Divergence Pt. 2

The add-ons were:


Even so it was a hassle to maintain the filter lists, in particular it involved hours of endless scrolling through rules to add a new rule to the end of a particular section or deleting one, updating the timestamp to the current one following the ISO 8601 standard often using non-maintainer's timezone, bumping the version, changing the description and many things more.

That's where ADBT - a language that defines template files and provides ways of writing reusable, component-like ad-block filter files and its compiler Aria came into play.

After creating the before-mentioned solutions, AdVoid was split even further into small chunks of rules, properly separated and organized which allowed for easier maintenance, less time scrolling through endless lists of rules and more importantly it allowed re-use of rules, i.e. rules that were repeating, e.g. URLs that were blocked in all 3 modules: AdVoid.Core, AdVoid.DNS, AdVoid.Full were consolidated in a single file and Aria would fetch the URL rules from the given file and apply transformations when needed, e.g. domain rules are stripped of all modifiers for the AdVoid.DNS module.


🚀 Productivity Gains

Since Aria saves a substantial amount of time needed for maintaining filter lists, Aria has allowed the productivity to increase exponentially which in turn allowed for rule additions/deletions to skyrocket, see the graph below. 🚀


Aria compiler impact graph - rule additions skyrocketed with AdVoid by Igor Dimitrijević (@igorskyflyer), powered by ADBT
Figure 2. a graph showing substantial increase of rule commits (Jan - Dec, 2023) when using the Aria compiler


🍪 Let's crunch those numbers! 🍪

Prior to implementing ADBT template files and using the Aria compiler, which occurred in mid August, 2023, there were ~352 rule commits per month.

After implementing the before-mentioned solutions there were ~4240 rule commits per month (+1104.5%), while commits reached their peak in December, with staggering ~5861 rule commits (+1565.1%).


⚠️ Disclaimer

AdVoid is provided as-is, without warranty of any kind. While every effort is made to ensure the accuracy and effectiveness of its modules, add-ons and scriptlets, its users are solely responsible for how and where they use AdVoid in their own, local environments.

By using AdVoid, you acknowledge that:

  • YOU understand the risks associated with ad-blocking and/or scriptlet usage.
  • YOU accept full responsibility for any site breakage, content disruption, or unintended behavior.
  • YOU agree not to hold the maintainers liable for any direct or indirect consequences resulting from its use.

💡 Use only what you trust. Review before you subscribe.


† The author might earn commissions with some affiliate links, but at no cost to you. These earnings help support ongoing updates, maintenance, and future development of the project.


🪪 License

Licensed under the GPLv3 license.



💖 Support

I work hard for every project, including this one and your support means a lot to me!
Consider buying me a coffee. ☕

Ko-fi donation button - support Igor Dimitrijević (@igorskyflyer), creator of AdVoid ad-block filter lists

Thank you for supporting my efforts! 🙏😊


🧬 Related

@igorskyflyer/aria

🧬 Meet Aria, an efficient ad-block filter list compiler, with many features that make your maintenance of ad-block filter lists a breeze! 🦖


@igorskyflyer/adblock-filter-counter

🐲 A dead simple npm module that counts ad-block filter rules.🦘


@igorskyflyer/biome-config

👽 An opinionated config for Biome to be used in JavaScript, TypeScript, JSX, TSX and any JavaScript-related projects. 🐺


@igorskyflyer/strip-headings

⛸ Strips Markdown headings!🏹


@igorskyflyer/adblock-header-extract

✂️ An npm module that provides ways to extract header and metadata from an ad-block filter file. 📃




👨🏻‍💻 Author

Created by Igor Dimitrijević (@igorskyflyer).

About

🛡️ A set of modular, highly‑optimized, and efficient filter lists that block ads, trackers, malware, phishing, and intrusive web clutter - from cookie banners to fake links. 👾

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Sponsor this project