AWAvenue-Ads-Rule/assets/README_en-US.md
2025-06-30 15:35:52 +08:00

130 lines
7.6 KiB
Markdown

<div align="left">
<a href="/README.md">Chinese</a>&nbsp;|&nbsp;
<a href="/assets/README_en-US.md">English</a> &nbsp;|&nbsp;
<a href="/assets/README_Update.md">Changelog</a> &nbsp;|&nbsp;
<a href="https://doc.awads.cc/?source=GitHub">WebSite [CHINA]</a> &nbsp;|&nbsp;
<a href="https://awavenue.top/?source=GitHub">WebSite [GLOBAL]</a>
</div>
<h1 align="center">-AWAvenue Ads Rule-</h1>
<p align="center">
<img src="https://img.jsdelivr.com/raw.githubusercontent.com/TG-Twilight/AWAvenue-Ads-Rule/main/assets/assets.png">
</p>
<p align="center">
<img src="https://img.shields.io/github/stars/TG-Twilight/AWAvenue-Ads-Rule?style=for-the-badge&colorA=FFEBEB&colorB=FFD9DC&logo=github&logoColor=black">
<a href="https://t.me/AWAvenueAdsRule">
<img src="https://img.shields.io/badge/dynamic/json?style=for-the-badge&colorA=DAE9FC&colorB=056DE8&label=Channel&logo=telegram&query=%24.data.totalSubs&url=https%3A%2F%2Fapi.spencerwoo.com%2Fsubstats%2F%3Fsource%3Dtelegram%26queryKey%3DAWAvenueAdsRule" alt="Telegram">
</a>
<a href="https://t.me/AWAvenueAdsChat">
<img src="https://img.shields.io/badge/dynamic/json?style=for-the-badge&colorA=DAE9FC&colorB=056DE8&label=Group&logo=telegram&query=%24.data.totalSubs&url=https%3A%2F%2Fapi.spencerwoo.com%2Fsubstats%2F%3Fsource%3Dtelegram%26queryKey%3DAWAvenueAdsChat" alt="Telegram">
</a>
</p>
<p align="center"><b>Eliminate All Malicious Ads</b></p>
## 🍁 About
As one of the best upstream and open-source ad filter lists in the community, AWAvenue Ads Rule achieves top-notch ad blocking, privacy protection, and traffic saving. It supports all common network-level ad-blocking and proxy tools¹. Compared to other ad rule lists with thousands of entries, AWAvenue Ads Rule is extremely compact, highly effective, and requires minimal hardware resources.
After subscribing to this rule list, you'll notice that annoying shake ads disappear, ads in subscription lists and at the end of articles won't load, autoplay ad videos vanish, TV box/smart TV boot ads are gone, and your device storage may even increase (since ad files are blocked from downloading).
Compared to other ad removal methods, this network-level filtering is cost-effective, easy to use, and widely beneficial (e.g., router deployment). You don't need to configure each app individually; ads are filtered seamlessly without affecting your normal app usage.
*As of June 2025, we can block over 90% of ad SDK content in Teyvat.*
### *If you have comments or suggestions about AWAvenue Ads Rule, please check our [FAQ](https://awavenue.top/Knowledge.html#%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98-%E4%B8%8E%E7%AD%94%E7%96%91) before submitting an issue or providing feedback in the group. The FAQ may answer your questions.*
---
## 🍁 How It Works
We block (intercept) rogue ad SDKs and their server interactions at the network layer, preventing them from loading and thus achieving ad removal.
---
## 🍁 Subscription Links
Compatible with AdGuard Home, AdGuard, AdGuard DNS, and other ad-blocking tools supporting Adblock syntax:
- [GitHub Raw subscription link](https://raw.githubusercontent.com/TG-Twilight/AWAvenue-Ads-Rule/main/AWAvenue-Ads-Rule.txt)
- [Tianming CFCDN subscription link](https://github.boki.moe/https://raw.githubusercontent.com/TG-Twilight/AWAvenue-Ads-Rule/main/AWAvenue-Ads-Rule.txt)
- [jsDelivr (gcore) subscription link](https://gcore.jsdelivr.net/gh/TG-Twilight/AWAvenue-Ads-Rule@main/AWAvenue-Ads-Rule.txt)
- [ghproxy subscription link](https://ghfast.top/https://raw.githubusercontent.com/TG-Twilight/AWAvenue-Ads-Rule/main/AWAvenue-Ads-Rule.txt)
For more formats and accelerated subscription links, see [Official Website - Subscription Rules](https://awavenue.top/Sub.html)
---
## 🍁 Supported Tools
AWAvenue Ads Rule is compatible with most existing ad-blocking and proxy tools, such as:
[AdGuard (iOS/Android)/Home/DNS](https://awavenue.top/Sub.html#adguard-ios-android-home-dns-%E8%AE%A2%E9%98%85%E9%93%BE%E6%8E%A5) and most other tools supporting Adblock syntax (excluding AdGuard for Chrome);
[AdAway, Dasheng Purify](https://awavenue.top/Sub.html#hosts-%E8%AE%A2%E9%98%85%E9%93%BE%E6%8E%A5) and other tools supporting hosts format;
[Mosdns](https://awavenue.top/Sub.html#hosts-%E8%AE%A2%E9%98%85%E9%93%BE%E6%8E%A5:~:text=%E6%8E%A5%EF%BC%88.list%E6%A0%BC%E5%BC%8F%EF%BC%89-,Mosdns%20V5%20%E8%AE%A2%E9%98%85%E9%93%BE%E6%8E%A5,-AdClose%20rule%E6%A0%BC%E5%BC%8F), [Dnsmasq](https://awavenue.top/Sub.html#hosts-%E8%AE%A2%E9%98%85%E9%93%BE%E6%8E%A5:~:text=Dnsmasq%E6%A0%BC%E5%BC%8F%E8%AE%A2%E9%98%85%E9%93%BE%E6%8E%A5%EF%BC%88.conf%E6%A0%BC%E5%BC%8F%EF%BC%89), [Adblock Master Plus+, DNS Adblock](https://awavenue.top/Sub.html#hosts-%E8%AE%A2%E9%98%85%E9%93%BE%E6%8E%A5) and other rules adapted for OpenWrt tools;
[ClashMeta](https://awavenue.top/Sub.html#clash-%E8%A7%84%E5%88%99%E8%AE%A2%E9%98%85%E9%93%BE%E6%8E%A5), [QuantumultX (.list)](https://awavenue.top/Sub.html#clash-%E8%A7%84%E5%88%99%E8%AE%A2%E9%98%85%E9%93%BE%E6%8E%A5:~:text=QuantumultX%20%E8%AE%A2%E9%98%85%E9%93%BE%E6%8E%A5%EF%BC%88.list%E6%A0%BC%E5%BC%8F%EF%BC%89), ShadowRocket, Surge, Surfboard, Singbox and other mainstream proxy tools.
We also provide rules specifically adapted for RouterOS routers (*including 240.0.0.1/0.0.0.0 format*).
*If, after subscribing to AWAvenue Ads Rule, you still see in-app rogue ad SDKs displaying ads or experience false positives, please report it!*
---
## 🍁 How to Use
Please read our [official tutorial](https://awavenue.top/Knowledge.html) before use. If you still have questions, feel free to join our official group (see below) for help.
This is a personal project, updated occasionally. Issues and PRs are welcome. [😀Join AWAvenue Ads Rule Group](https://t.me/AWAvenueAdsChat).
---
<details>
<summary>Recommended Ad-Blocking Tools</summary>
- [AdGuard Home](https://github.com/AdguardTeam/AdGuardHome) *Install on your router for ideal ad-blocking; AWAvenue Ads Rule is already in AdGuard's official list, you can subscribe directly from "Select from list"!*
- [AdGuard](https://adguard.com/) *Available on multiple platforms: Android, Windows, Mac, iOS*
- [AdAway](https://adaway.org/) *AdAway is an open-source Android ad-blocker using hosts files.*
- [AdGuard DNS](https://adguard-dns.io/en/welcome.html) *Use custom DNS servers directly; AWAvenue Ads Rule is already in AdGuard DNS Filters, subscribe directly!*
- [AdGuard Home For Magisk](https://github.com/twoone-3/AdGuardHomeForMagisk) *Magisk version of AdGuard Home*
- [AdClose (Xposed module)](https://github.com/zjyzip/AdClose) *Xposed module for ad-blocking with AWAvenue Ads Rule built-in, thanks to @zjyzip*
- [geosite (@elysias123 branch)](https://github.com/elysias123/geosite) *Routing rule resources for V2Ray, Xray-core, mihomo, hysteria, Trojan-Go, leaf, with AWAvenue Ads Rule category included*
</details>
---
## 🍁 Special Sponsors
---
## 🍁 Contributors
<p align="left"><a href="https://github.com/TG-Twilight/AWAvenue-Ads-Rule/graphs/contributors"><img src="https://contrib.rocks/image?repo=TG-Twilight/AWAvenue-Ads-Rule&max=50" /></a></p>
---
## Star History
[![Stargazers over time](https://starchart.cc/TG-Twilight/AWAvenue-Ads-Rule.svg?variant=adaptive)](https://starchart.cc/TG-Twilight/AWAvenue-Ads-Rule)
---
<p align="left">
<img src="https://count.getloli.com/get/@TG-Twiligh?theme=booru-helltaker" alt="Profile Views" width="666"/>
</p>
Statistics started from June 2024. The statistics service may occasionally be unavailable...
---
> [@Github](https://github.com/TG-Twilight/AWAvenue-Ads-Rule) · [Channel](https://t.me/AWAvenueAdsRule) · [Group](https://t.me/AWAvenueAdsChat) · [Twilight's page](https://zyc.su/) · [秋风塬上](https://awads.cc/)