mirror of
https://github.com/AdguardTeam/AdguardFilters.git
synced 2026-08-31 12:23:36 +00:00
bff24b0917
* add readme badge for gh pages deployment status * fix wording * add branch=master to the badge scr url
81 lines
4.1 KiB
Markdown
81 lines
4.1 KiB
Markdown
<!-- markdownlint-disable -->
|
|
|
|
|
|
<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
|