___        __   _    __        _      __
   /   |  ____/ /  | |  / /____   (_)____/ /
  / /| | / __  /   | | / // __ \ / // __  / 
 / ___ |/ /_/ /    | |/ // /_/ // // /_/ /  
/_/  |_|\__,_/     |___/ \____//_/ \__,_/   
 

✈ An efficient AdBlock filter list that blocks ads, trackers, malware, phishing attempts, fake download links, fake search results, and a lot more if you want it to! Things like: cookie-consent banners, popups, modals, push notifications, survey, newsletter and subscribe popups, rating dialogs, sharing, Google Chromecast, popup chats, post widgets, like widgets, comments, service workers, news widgets, JavaScript and CSS maps, PWA install banners, Webmanifests, SWF objects, website reporters, skips countdowns, etc. 👾

If you are new to ad-blocking, make sure to read the QUICKSTART first. 😉

💖 Support further development

I work hard for every project, including this one and your support means a lot to me!
Consider buying me a coffee. ☕
Thank you for supporting my efforts! 🙏😊



Igor Dimitrijević (@igorskyflyer)

💕Since Dec 19 2022, this project is supported by the AdGuard ^(*) team. 🥳
_{* support via a free developer license being given}

👽 Since Aug 14 2023, this project has been powered by ADBT - a language that defines template files and provides ways of writing reusable, component-like based Adblock filter files and its compiler Aria that substantially increase productivity and cut off the time needed for maintaining these filter lists, which means more frequent updates and delivery on a daily basis.

Read more about this in the Genesis section of this page.

🚨 IMPORTANT

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

🤹🏼‍♂️ Usage

Install it into your ad-blocker by clicking on following subscribe button or by manually adding a filter list with the URL of:

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

If you are using a system-wide ad-blocker it is also beneficial to add this filter list by clicking on the following button or by manually adding a filter list with the URL of:

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

This filter list will block network requests at a lower (DNS) level, which improves page load and/or performance of Web pages.

---

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

😒   AdVoid.Addon.NoAnnoyances  

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

💬   AdVoid.Addon.NoExternals  

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

🦄   AdVoid.Addon.NoExtras  

Blocks non-essential resources like service workers, news widgets, JavaScript and CSS maps, PWA install banners, Webmanifests, SWF objects, etc.

🧪   AdVoid.Addon.Experiments  

Unstable and experimental filter list, use only for testing purposes and with caution since it may break certain sites.

---

🫱🏽‍🫲🏼 Zero hassle

If you don't want to bother adding multiple filter lists, you can get all of them bundled into one filter list - all except AdVoid.Addon.Experiments and scriptlets.

You can add the bundled filter list by clicking here 👉🏼 or by manually adding a filter list with the URL of:

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

---

🧬 Genesis

📚 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 add-ons and modules - for easier maintenance.

🐛 Divergence pt. 1

The modules are:

• 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 are:

• AdVoid.Addon.NoAnnoyances - blocks site annoyances like cookie-consent banners, popups, etc.
• AdVoid.Addon.NoExternals - blocks external features, like sharing, Google Chromecast, etc.
• AdVoid.Addon.NoExtras - blocks non-essential resources like news widgets, JavaScript and CSS maps, PWA install banners, etc.
• AdVoid.Addon.Experiments - unstable and experimental filter list, use only for testing purposes and with caution since it may break certain sites.

---

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 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 based Adblock filter files and its compiler Aria come into play.

After creating the before-mentioned solutions, AdVoid was split even further into small chunks of rules, properly 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 are blocked in all 3 modules: AdVoid.Core, AdVoid.DNS, AdVoid.Full are contained in a single file and Aria fetches the URLs from the given file and applies transformations when needed, e.g. domain rules are stripped of all modifiers for the AdVoid.DNS module.

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

_{Figure 1: 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%).

---

🕺🏻 HAPPY BLOCKING! 🥳