<!-- markdownlint-disable -->
&nbsp;

<p align="center">
    <img width="275" alt="AdGuard Filters logo" src="https://cdn.adtidy.org/website/github.com/AdguardFilters/viking.svg" />
</p>

<h1 align="center">AdGuard Filters</h1>
<h3 align="center">The place where ad trackers are actually blocked</h3>

<p align="center">
    <a href="https://github.com/AdguardTeam/AdguardFilters/actions/workflows/aglint.yml" target="_blank"><img src="https://github.com/AdguardTeam/AdguardFilters/actions/workflows/aglint.yml/badge.svg?branch=master" alt="AGLint status"></a>
    <a href="https://github.com/AdguardTeam/AdguardFilters/actions/workflows/pages/pages-build-deployment" target="_blank"><img src="https://github.com/AdguardTeam/AdguardFilters/actions/workflows/pages/pages-build-deployment/badge.svg?branch=master" alt="GitHub Pages deployment"></a>
</p>

<p align="center">
    <a href="https://github.com/AdguardTeam/AdguardFilters/blob/master/LICENSE" target="_blank"><img src="https://img.shields.io/github/license/AdguardTeam/AdguardFilters" alt="License"></a>
    <a href="https://github.com/AdguardTeam/AdguardFilters/graphs/contributors" target="_blank"><img src="https://img.shields.io/github/contributors/AdguardTeam/AdguardFilters" alt="GitHub contributors"></a>
    <a href="https://github.com/AdguardTeam/AdguardFilters/graphs/commit-activity" target="_blank"><img src="https://img.shields.io/github/commit-activity/m/AdguardTeam/AdguardFilters" alt="GitHub commit activity"></a>
    <a href="https://github.com/AdguardTeam/AdguardFilters/issues" target="_blank"><img src="https://img.shields.io/github/issues/AdguardTeam/AdguardFilters" alt="GitHub issues"></a>
    <a href="https://github.com/AdguardTeam/AdguardFilters/issues?q=is%3Aissue+is%3Aclosed" target="_blank"><img src="https://img.shields.io/github/issues-closed/AdguardTeam/AdguardFilters" alt="GitHub closed issues"></a>
</p>
<!-- markdownlint-restore -->

This is the place where we create filters for [AdGuard][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]: https://adguard.com/

## AdGuard Filters Policy

Our filter policy is available [here][policy].

[policy]: https://adguard.com/kb/general/ad-filtering/filter-policy/

## 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][report].

[report]: https://agrd.io/report

### 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][documentation] on AdGuard filtering rules
syntax. You'll need to read it before you'll be able to create your own
filtering rules.

[documentation]: https://adguard.com/kb/general/ad-filtering/create-own-filters/

### Other ways to contribute

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

[contribute]: https://adguard.com/contribute.html
