Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/the-advoid/ad-void

✈️ 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 and a lot more! 👾
https://github.com/the-advoid/ad-void

adblock adblock-filter ads advertisement block browser chrome chrome-extension enhancement extension filter full-stack hosts igorskyflyer utility vite

Last synced: 11 days ago
JSON representation

✈️ 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 and a lot more! 👾

Awesome Lists containing this project

README 

          


  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



- [**Quickstart**](#ℹ️-quickstart)

- [**Features**](#-features)

- [**Usage**](#-usage)

  - [**Modules**](#-modules)

    - [**Full**](#️-advoidfull)

    - [**Core**](#-advoidcore)

    - [**Lite**](#-advoidlite)

    - [**DNS**](#-advoiddns)

  - [**Add-ons**](#-add-ons)

    - [**NoAnnoyances**](#-advoidaddonnoannoyances)

    - [**NoExternals**](#-advoidaddonnoexternals)

    - [**NoExtras**](#-advoidaddonnoextras)

    - [**Experiments**](#-advoidaddonexperiments)

  - [**Scriptlets**](#-scriptlets)

    - [**AntiAntiAdBlock**](#-advoidscriptletsantiantiadblock)

- [**Filter Trust**](#️-filter-trust)

- [**Legacy**](#-legacy)

- [**Case Study**](#-case-study)

  - [**Divergence Pt. 1**](#-divergence-pt-1)

  - [**Divergence Pt. 2**](#-divergence-pt-2)

- [**Productivity Gains**](#-productivity-gains)

- [**Disclaimer**](#️-disclaimer)

- [**Support**](#-support)

- [**License**](#-license)

- [**Related**](#-related)

- [**Author**](#-author)










## 🤖 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**](#️-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**](#️-advoidfull) and by ~12% than [**AdVoid.Core**](#-advoidcore).







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**](https://github.com/the-advoid/ad-void/tree/main/legacy) 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**](https://github.com/adbt-lang/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**](https://github.com/the-advoid/ad-void/blob/main/AdVoid.Core.txt) - core functionality (ad-blocking, URL + cosmetic)

- [**AdVoid.DNS**](https://github.com/the-advoid/ad-void/blob/main/AdVoid.DNS.txt) - DNS-blocking (URL only)

- [**AdVoid.Full**](https://github.com/the-advoid/ad-void/blob/main/AdVoid.Full.txt) - full content blocking (core functionality + add-ons)







#### 🐛 Divergence Pt. 2



The add-ons were:

- [**AdVoid.Addon.NoAnnoyances**](https://github.com/the-advoid/ad-void/blob/main/add-ons/AdVoid.Addon.NoAnnoyances.txt) - blocks site annoyances: cookie-consent banners, popups, etc.

- [**AdVoid.Addon.NoExternals**](https://github.com/the-advoid/ad-void/blob/main/add-ons/AdVoid.Addon.NoExternals.txt) - blocks external features: sharing, Google Chromecast, etc.

- [**AdVoid.Addon.NoExtras**](https://github.com/the-advoid/ad-void/blob/main/add-ons/AdVoid.Addon.NoExtras.txt) - blocks non-essential resources: news widgets, JavaScript and CSS maps, PWA install banners, etc.

- [**AdVoid.Addon.Experiments**](https://github.com/the-advoid/ad-void/blob/main/add-ons/AdVoid.Addon.Experiments.txt) - 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 often using non-maintainer's timezone, bumping the version, changing the description and many things more.



> That's where [**ADBT**](https://github.com/adbt-lang/adbt) - a language that defines template files and provides ways of writing reusable, component-like ad-block filter files and its compiler [`Aria`](https://github.com/aria-toolkit/aria-cli) came into play.



After creating the before-mentioned solutions, [**AdVoid**](https://github.com/the-advoid/ad-void) 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**](https://github.com/the-advoid/ad-void/blob/main/AdVoid.Core.txt), [**AdVoid.DNS**](https://github.com/the-advoid/ad-void/blob/main/AdVoid.DNS.txt), [**AdVoid.Full**](https://github.com/the-advoid/ad-void/blob/main/AdVoid.Full.txt) were consolidated in a single file and [`Aria`](https://github.com/aria-toolkit/aria-cli) 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**](https://github.com/the-advoid/ad-void/blob/main/AdVoid.DNS.txt) module.







### 🚀 Productivity Gains



Since [`Aria`](https://github.com/aria-toolkit/aria-cli) 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`](https://github.com/aria-toolkit/aria-cli) 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**](https://github.com/the-advoid/ad-void/blob/main/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**](https://www.npmjs.com/package/@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**](https://www.npmjs.com/package/@igorskyflyer/adblock-filter-counter)



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







[**@igorskyflyer/biome-config**](https://www.npmjs.com/package/@igorskyflyer/biome-config)



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







[**@igorskyflyer/strip-headings**](https://www.npmjs.com/package/@igorskyflyer/strip-headings)



> _⛸ Strips Markdown headings!🏹_







[**@igorskyflyer/adblock-header-extract**](https://www.npmjs.com/package/@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*](https://github.com/igorskyflyer/)).