Convert Figma logo to code with AI

AdguardTeam logoAdguardFilters

AdGuard Content Blocking Filters

3,069
621
3,069
255

Top Related Projects

45,801

uBlock Origin - An efficient blocker for Chromium and Firefox. Fast and lean.

EasyList filter subscription (EasyList, EasyPrivacy, EasyList Cookie, Fanboy's Social/Annoyances/Notifications Blocking List)

Automatically updated, moderated and optimized lists for blocking ads, trackers, malware and other garbage

26,451

🔒 Consolidating and extending hosts files from several well-curated sources. Optionally pick extensions for porn, social media, and other categories.

Quick Overview

AdguardTeam/AdguardFilters is a GitHub repository containing filter lists used by AdGuard products to block ads, trackers, and other unwanted content on the web. These filters are regularly updated and maintained by the AdGuard team and community contributors, providing comprehensive protection for users across various platforms and browsers.

Pros

  • Extensive coverage: Includes filters for multiple categories such as ad blocking, privacy protection, and social media tracking
  • Regularly updated: Frequent updates ensure protection against the latest threats and ad techniques
  • Community-driven: Allows contributions from users, improving the overall quality and effectiveness of the filters
  • Cross-platform compatibility: Works with various AdGuard products and can be used in other ad-blocking solutions

Cons

  • May cause false positives: Some legitimate content might be blocked unintentionally
  • Requires regular updates: Users need to keep their filter lists up-to-date for optimal protection
  • Can impact website functionality: Aggressive filtering may break some website features or layouts
  • Resource-intensive: Large filter lists can consume more memory and processing power

Getting Started

To use AdGuard filters in your ad-blocking solution:

  1. Visit the AdguardTeam/AdguardFilters repository on GitHub.
  2. Navigate to the desired filter list (e.g., EnglishFilter/sections/adservers.txt).
  3. Copy the raw URL of the filter list.
  4. Add the URL to your ad-blocking software's custom filter list section.

For AdGuard products, these filters are typically included by default. To enable or disable specific filters:

  1. Open your AdGuard application settings.
  2. Navigate to the "Filters" or "Content Blocking" section.
  3. Select or deselect the desired filter lists.
  4. Click "Apply" or "Save" to update your settings.

Remember to keep your filters updated regularly for the best protection against ads and trackers.

Competitor Comparisons

45,801

uBlock Origin - An efficient blocker for Chromium and Firefox. Fast and lean.

Pros of uBlock

  • Lightweight and efficient, using less system resources
  • Open-source with a large community of contributors
  • Highly customizable with advanced features for power users

Cons of uBlock

  • Less user-friendly interface for beginners
  • Fewer pre-configured filter lists compared to AdguardFilters
  • May require more manual configuration for optimal performance

Code Comparison

uBlock:

µBlock.staticNetFilteringEngine.fromCompiledContent(compiledFilters, writer);

AdguardFilters:

adguard.rules.addRule(rule);

Both repositories focus on content filtering and ad-blocking, but their approaches differ. uBlock emphasizes efficiency and customization, while AdguardFilters offers a more user-friendly experience with extensive pre-configured filters.

uBlock's code tends to be more low-level and performance-oriented, while AdguardFilters' code is often more abstracted and easier to read. However, both projects are actively maintained and regularly updated to address new challenges in content filtering and ad-blocking.

Ultimately, the choice between these two repositories depends on the user's needs, technical expertise, and desired level of control over their browsing experience.

EasyList filter subscription (EasyList, EasyPrivacy, EasyList Cookie, Fanboy's Social/Annoyances/Notifications Blocking List)

Pros of EasyList

  • Longer history and wider adoption in the ad-blocking community
  • More frequent updates, often multiple times per day
  • Broader coverage of international websites and languages

Cons of EasyList

  • Less focus on privacy-specific filters
  • May include some outdated or redundant rules
  • Lacks some advanced features like DNS blocking rules

Code Comparison

EasyList:

! Example EasyList rule
||example.com/ads/*$script,third-party

AdguardFilters:

! Example AdguardFilters rule
||example.com/ads/*$script,third-party
! DNS rule (not available in EasyList)
||ads.example.com^$dnsrewrite=NXDOMAIN

Both repositories use similar syntax for basic filtering rules. However, AdguardFilters includes additional rule types, such as DNS blocking rules, which are not present in EasyList.

EasyList tends to have a larger number of general-purpose rules, while AdguardFilters often includes more specific and targeted rules for various types of content blocking.

Overall, both repositories serve similar purposes but cater to slightly different use cases and preferences within the ad-blocking community. EasyList is more widely adopted and frequently updated, while AdguardFilters offers some advanced features and a stronger focus on privacy-oriented filtering.

Automatically updated, moderated and optimized lists for blocking ads, trackers, malware and other garbage

Pros of hosts-blocklists

  • Simpler implementation using hosts file format
  • Potentially faster processing due to straightforward host-based blocking
  • More universal compatibility across different systems and devices

Cons of hosts-blocklists

  • Less granular control over blocking rules
  • May cause over-blocking of subdomains
  • Limited ability to create complex filtering rules

Code Comparison

hosts-blocklists:

0.0.0.0 example.com
0.0.0.0 ads.example.com

AdguardFilters:

||example.com^
||ads.example.com^
@@||safe.example.com^

The hosts-blocklists project uses a simple hosts file format, which is easy to implement but lacks flexibility. Each line contains an IP address (usually 0.0.0.0) followed by a domain to block.

AdguardFilters uses a more advanced syntax that allows for more complex rules. The || syntax matches domain and subdomains, while @@ creates exceptions. This approach offers greater control and precision in filtering.

While hosts-blocklists is simpler and more universally compatible, AdguardFilters provides more powerful and flexible filtering options at the cost of increased complexity.

26,451

🔒 Consolidating and extending hosts files from several well-curated sources. Optionally pick extensions for porn, social media, and other categories.

Pros of hosts

  • Simpler, more straightforward approach to blocking
  • Lightweight and easy to implement across various systems
  • Can be used directly with operating systems' hosts files

Cons of hosts

  • Less granular control over blocking rules
  • May cause over-blocking in some cases
  • Limited ability to handle complex filtering scenarios

Code Comparison

hosts:

0.0.0.0 example.com
0.0.0.0 ads.example.com

AdguardFilters:

||example.com^
||ads.example.com^
@@||example.com/allowed-content

The hosts file uses a simple IP redirection approach, while AdguardFilters employs more complex syntax allowing for exceptions and fine-tuned blocking.

Key Differences

  • Scope: hosts focuses on domain-level blocking, while AdguardFilters offers more diverse filtering options.
  • Flexibility: AdguardFilters provides more advanced features like element hiding and script injection.
  • Maintenance: hosts is community-driven with less frequent updates, whereas AdguardFilters is actively maintained by a dedicated team.

Use Cases

hosts is ideal for users seeking a simple, system-wide blocking solution. AdguardFilters is better suited for those requiring detailed control over web content filtering, especially within browser extensions or dedicated ad-blocking software.

Convert Figma logo designs to code with AI

Visual Copilot

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

README

 

AdGuard Filters logo

AdGuard Filters

The place where ad trackers are actually blocked

AGLint status License GitHub contributors GitHub commit activity GitHub issues GitHub closed issues

This is the place where we create filters for AdGuard and other ad-blocking software, such as uBlock Origin. Each filter consists of a set of text-based rules that AdGuard apps and programs use to filter out advertisements and privacy-invasive content like banners, pop-ups, and trackers. Rules specific to a certain region (e.g., German filter, Russian filter) or serving a specific purpose (e.g., Social Media filter, Tracking Protection filter) are combined into a single list, or filter, that can be enabled or disabled all at once.

Our filters are constantly updated. This repository allows anyone to bring our attention to anything from overlooked ads to false positives, helping us refine our filters, improve them, and keep them current.

We are proud of the fact that AdGuard Filters are among the most actively developed content-blocking filter lists available, if not the most.

AdGuard Filters Policy

Our filter policy is available here.

Contributing to AdGuard

We are blessed to have a community that does not only love AdGuard, but also gives back. A lot of people volunteer in various ways to make other users' experience with AdGuard better, and you can join them! We, on our part, can only be happy to reward the most active members of the community. So, what can you do?

Report Issues

To submit a report, please use this reporting tool.

Suggest Filtering Rules

You will find a lot of open issues, each one referencing a problem with some website — a missed ad, a false positive etc. — choose any one and suggest your own rules in comments. AdGuard filter engineers will review your suggestions, and if they find them correct, your rules will be added to AdGuard filters.

Here is the official documentation on AdGuard filtering rules syntax. You'll need to read it before you'll be able to create your own filtering rules.

Other ways to contribute

Here is a dedicated page for people willing to contribute to AdGuard.