explaingit

tg-twilight/awavenue-ads-rule

★ 5,921Adblock Filter ListAudience · generalComplexity · 1/5Setup · easy

TLDR

A community-maintained ad-blocking filter list that blocks ad servers inside Chinese apps at the network level, compatible with AdGuard, ClashMeta, ShadowRocket, and many other tools.

Mindmap

mindmap
  root((awavenue-ads-rule))
    What it does
      Blocks ad servers
      Network-level blocking
      Chinese app coverage
    Compatible tools
      AdGuard
      AdGuard Home
      ClashMeta
      ShadowRocket
    Use cases
      Mobile ad blocking
      Router-wide blocking
      DNS filtering
    Audience
      Chinese app users
      Home network admins
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Block over 90% of ad SDK traffic in popular Chinese apps on your phone by adding this list to AdGuard for Android or iOS

USE CASE 2

Set up network-wide ad blocking for all devices on a home router using AdGuard Home or AdGuard DNS with this filter list

USE CASE 3

Use with ClashMeta or ShadowRocket to block Chinese app ads at the DNS level across an entire iOS device

Tech stack

Adblock Filter List

Getting it running

Difficulty · easy Time to first run · 5min
No license information is mentioned in the repository description.

In plain English

AWAvenue Ads Rule (Autumn Wind Ad Rule) is a curated ad-blocking filter list maintained by an open-source community, primarily aimed at users in mainland China. Rather than a traditional software application, this repository is a regularly updated text file containing rules that tell compatible network-level blocking tools which domains and servers to block. The list works at the network layer, meaning it blocks the servers that ad SDKs inside apps try to contact. When an app reaches out to an advertising server and that server is on the block list, the connection is refused before any ad content is loaded or downloaded. This approach applies across all apps on a device without needing to configure each one individually. According to the README, the list can block over 90 percent of ad SDK traffic on mainstream Chinese apps as of mid-2025. The rule file is compatible with a wide range of blocking tools: AdGuard (on iOS, Android, Windows, and Mac), AdGuard Home and AdGuard DNS (which can be deployed on a router to cover an entire network), AdAway (an Android ad blocker using the hosts file format), Mosdns, Dnsmasq, ClashMeta, QuantumultX, ShadowRocket, Surge, and others. Several download mirrors are provided for users who have difficulty accessing GitHub directly. The project is maintained by a single developer and is updated informally. Users can report missed ads or false positives via GitHub Issues or a Telegram group. The repository README is written in Chinese, with an English translation available as a separate file.

Copy-paste prompts

Prompt 1
How do I add the AWAvenue Ads Rule filter list to AdGuard for Android to block ads inside Chinese apps?
Prompt 2
Configure AdGuard Home to subscribe to the AWAvenue Ads Rule list and block Chinese ad SDK servers across my whole network
Prompt 3
How do I import the Autumn Wind Ad Rule into ClashMeta on my phone to block ad traffic from Chinese apps?
Open on GitHub → Explain another repo

← tg-twilight on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.