gitwtfhub

wtf is anti-ad?

privacy-protection-tools/anti-ad — explained in plain English

Analysis updated 2026-06-24

10,389Audience · generalComplexity · 1/5Setup · easy

TL;DR

A regularly updated DNS blocklist focused on Chinese-language ad and tracking domains, subscribe with AdGuardHome, Pi-Hole, Clash, or similar tools to block ads across all devices on your network.

Mindmap

mindmap
  root((anti-AD))
    Purpose
      Block Chinese Ads
      Block Trackers
    How It Works
      DNS Level Blocking
      Merged Upstream Lists
    Supported Tools
      AdGuardHome
      Pi-Hole
      Clash
      Dnsmasq
    Formats
      Multiple File Formats
      Auto Updated

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

Why would anyone build with this?

REASON 1

Block Chinese-language ads on smart TV boxes and mobile apps at the network level without any browser extension.

REASON 2

Add Chinese ad domain coverage to AdGuardHome or Pi-Hole to catch ads that generic blocklists miss.

REASON 3

Block tracking and analytics domains that quietly collect personal data on the Chinese-language internet.

REASON 4

Subscribe to a regularly maintained, deduplicated blocklist that automatically merges dozens of upstream sources.

How it stacks up

privacy-protection-tools/anti-admudblazor/mudblazormicrosoft/wsl2-linux-kernel
Stars10,38910,38910,390
LanguageC#C
Setup difficultyeasyeasyhard
Complexity1/52/55/5
Audiencegeneraldeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

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

Wtf does this do

anti-AD is a regularly updated blocklist aimed at the Chinese-language internet. Its purpose is to block ads and stop websites from quietly collecting personal data. It focuses on achieving a high hit rate for Chinese ad domains, meaning it catches a large proportion of ads that other general blocklists miss. The list works at the DNS level. Instead of blocking ads after a page loads, it prevents your device from even reaching the ad server by blocking the domain name lookup. This approach works across websites, smart TV boxes, and in-app ads inside mobile applications. It also blocks domains known to gather analytics data and personal information without user awareness. To use anti-AD, you add one of its filter files to a supported tool. The project provides files in multiple formats to cover the most common network tools: AdGuardHome, dnsmasq, Pi-Hole, Surge, Clash, mihomo, smartdns, and sing-box. Each tool has a matching file format available for download directly from the project's website or from GitHub. Behind the scenes, the project merges dozens of upstream blocklists from other well-known sources, removes duplicate entries, strips out expired domains, and applies additional processing to improve accuracy. This is meant to reduce false positives (accidentally blocking things that are not ads) while maximizing coverage of actual ad and tracking domains. A curated list of disputed domains is also maintained separately for cases where a domain serves both ads and legitimate functions, so users can decide for themselves whether to block them. The project is fully open source, and all filter rules are sourced from upstream lists or contributed by users through the issue tracker. The README and most of the project documentation are written in Chinese.

Yoink these prompts

Prompt 1
I'm running AdGuardHome on my home network. Give me the exact URL to add anti-AD's AdGuardHome filter file as a custom blocklist subscription.
Prompt 2
I use Pi-Hole. How do I add the anti-AD blocklist to block Chinese ad domains, and how often does it need to be refreshed?
Prompt 3
I want to use anti-AD with Clash on my router. Which file format should I use and how do I add it to my Clash configuration?
Prompt 4
How do I self-host the anti-AD filter file so my Pi-Hole pulls updates from my own server instead of GitHub?

Frequently asked questions

wtf is anti-ad?

A regularly updated DNS blocklist focused on Chinese-language ad and tracking domains, subscribe with AdGuardHome, Pi-Hole, Clash, or similar tools to block ads across all devices on your network.

What license does anti-ad use?

No license information is mentioned in the explanation.

How hard is anti-ad to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is anti-ad for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.