explaingit

ublockorigin/uassets

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

TLDR

Filter lists for uBlock Origin that block ads, trackers, anti-blocker walls, popups, and video ads. Also the place to report broken sites or missed ads caused by uBlock Origin filters.

Mindmap

mindmap
  root((uAssets))
    Filter Lists
      Ad blocking rules
      Tracker blocking
      Anti-blocker walls
      Popup rules
    Policy
      High-traffic sites only
      Temporary fixes
      No paywall filters
    EasyList Pipeline
      Supplement EasyList
      Fixes migrate upstream
      Remove after merge
    Issue Reporting
      Broken site reports
      Missed ad reports
      Troubleshooting steps
    Contributions
      Community reports
      Filter submissions
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 ads and trackers on high-traffic websites that slip past standard EasyList rules.

USE CASE 2

Fix broken websites where uBlock Origin is too aggressive and blocks content it should not.

USE CASE 3

Block anti-blocker walls that prevent you from reading content when a site detects your ad blocker.

USE CASE 4

Report missed video ads, popups, or sites that swap in new ads after detecting your blocker.

Tech stack

Adblock Filter ListuBlock OriginEasyListEasyPrivacy

Getting it running

Difficulty · easy Time to first run · 5min

No installation needed beyond uBlock Origin itself, these filter lists load automatically. To report an issue, disable other extensions first, then use the uBlock Origin troubleshooting button to gather details.

License not mentioned in the explanation.

In plain English

This repository holds the filter lists used by uBlock Origin, a popular browser extension that blocks ads and trackers. Filter lists are text files full of rules that tell the blocker which web requests to block or allow. This particular set of lists is maintained by the uBlock Origin team and supplements the widely-used EasyList and EasyPrivacy lists that most ad blockers share. The repository serves two purposes. First, it stores the actual filter files that uBlock Origin loads to do its blocking work. Second, it acts as the place where users and contributors report problems: either a website is showing ads that should be blocked, or a website is broken because a filter is too aggressive and is blocking something it should not. The rules here follow a specific policy. The team will add filters to handle ad reinsertion (when a site detects you have a blocker and swaps in different ads anyway), anti-blocker walls that prevent you from reading content, popups, video ads, and situations where a site disables your ability to copy or paste text. They do not add filters for paywalls or certain categories of sites. Filters added here are meant to be temporary fixes for high-traffic websites. The preferred outcome is for those fixes to eventually be accepted into EasyList, the community-maintained list that all major blockers use. Once a fix makes it into EasyList, it can be removed from this repository. If you encounter a broken website while using uBlock Origin, the README explains how to report it: disable other extensions first to confirm the cause, then use the troubleshooting information button inside the uBlock Origin icon to gather diagnostic details before filing a report.

Copy-paste prompts

Prompt 1
I use uBlock Origin and a website is broken, certain content won't load. How do I figure out which filter rule is causing it and report it to uAssets?
Prompt 2
A website is showing ads even though I have uBlock Origin enabled. Walk me through how to identify the ad and submit a filter request to the uAssets repository.
Prompt 3
Explain the difference between uAssets filter lists and EasyList, and why a fix might start in uAssets before moving to EasyList.
Prompt 4
A site is showing an anti-blocker wall that says I must disable my ad blocker. Does uBlock Origin have filters for this, and where would I report it if not?
Prompt 5
How do I use the uBlock Origin troubleshooting button to gather diagnostic info before filing a broken-site report on uAssets?
Open on GitHub → Explain another repo

← ublockorigin on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.