# yokoffing/filterlists: supplemental filter lists for uBlock Origin

> yokoffing/filterlists is a curated collection of supplemental filter lists designed to close privacy, annoyance, and security gaps that uBlock Origin's default lists leave open. The repository provides direct subscribe links for uBlock Origin and import instructions for AdGuard, Brave, and AdBlock Plus.

**yokoffing/filterlists** — Collection of blocklists to fill in the gaps

- Repository: https://github.com/yokoffing/filterlists
- Stars: 3,603 · Forks: 91
- Language: Unknown
- License: not declared
- Published: 2026-09-23 · Updated: 2026-09-23 · Language: en
- Canonical page: https://hysenlabs.com/projects/yokoffing-filterlists

## What yokoffing/filterlists provides and who it is for

uBlock Origin ships with a set of default filter lists covering the most common advertising and tracking domains. yokoffing/filterlists targets the gaps those defaults leave: tracker requests that EasyPrivacy does not block, third-party embedded players that load before the user interacts with them, cookie consent popups, and ad injection patterns specific to platforms like YouTube and Twitch.

The repository is aimed at power users who are already running uBlock Origin and want more precise control over what gets blocked. The README describes the guiding approach as applying the law of diminishing returns: blocking more does not always produce a better browsing experience, and adding redundant lists increases filter evaluation overhead without corresponding benefit. The goal is a small set of high-quality, non-overlapping lists.

The README notes the repository is specifically tailored to uBlock Origin and cannot guarantee filters will work in other ad blockers.

## The guiding philosophy: diminishing returns and list efficiency

The README opens with three guidelines. The first is to prevent overblocking by applying the law of diminishing returns: each additional list provides less incremental benefit while adding more rules to evaluate per page load. The second is to aim for efficiency without sacrificing quality, citing a Brave blog post on the cost of stale ad-blocking rules as a reference for why list freshness matters. The third is to use the minimum number of useful lists to avoid redundancy.

This philosophy shapes the repository's structure. Rather than including every available privacy or annoyance list, the README presents tiered setup examples (Enhanced, Pro, and Optimized) that vary in aggressiveness. The Enhanced tier adds a small set of curated lists on top of uBlock Origin's defaults. The Pro tier adds more. The Optimized tier is described as a configuration tuned for performance, particularly relevant for mobile browsers where each filter rule has a higher cost per page load.

The README also addresses Twitch and YouTube specifically with dedicated sections, since those platforms serve ads in ways that require additional countermeasures beyond what standard lists cover.

## Available filter lists by category

The README organizes lists into four categories: Privacy, Annoyances, Security, and All-Purpose.

In the Privacy category, Privacy Essentials is described as a curated list for advanced hardening with approximately 1,000 rules. It includes click-to-load filters that block requests to connect.facebook.com and similar third-party trackers not covered by uBlock Origin's defaults. The README warns that Privacy Essentials may prevent login through Facebook or Google third-party authentication.

The click2load filters, listed as approximately 47 rules, replace third-party audio and video players with click-to-load placeholders. The README notes this reduces bandwidth usage, page load time, and the number of domains contacted per page load.

The Annoyances category includes lists targeting cookie consent dialogs, newsletter popups, and general page-level annoyances. A clean reading experience list and a YouTube clear view list appear as separate files in the repository.

The Security category lists are documented in the README alongside subscribe links. The repository root directory shows the individual filter files including privacy_essentials.txt, annoyance_list.txt, click2load.txt, youtube_clear_view.txt, block_third_party_fonts.txt, and clean_reading_experience.txt.

## How to add filter lists to uBlock Origin, AdGuard, and Brave

For uBlock Origin, the README provides subscribe links for each list. Clicking a subscribe link opens a new browser tab showing a subscription confirmation button in the top right corner. After clicking Subscribe and closing the tab, the list is active.

For AdGuard, the subscribe link opens an import dialog where the list must be marked as Trusted before confirming.

For Brave Browser, the README explicitly states not to use the subscribe link. Instead, navigate to brave://adblock in the URL bar, open the raw file on GitHub by clicking Raw next to the file, copy the URL, and paste it under Add custom filter lists.

For AdBlock Plus, clicking the subscribe link opens a confirmation dialog to add the filter list. An AdBlock Plus-compatible branch of the lists, using ABP syntax, is maintained separately by a third party at the Metrokoto/filterlists-abp repository, as noted in the README.

For other ad blockers, the README instructs copying the raw GitHub URL of the list file and following the blocker's own import instructions, since the subscribe link format is specific to uBlock Origin and compatible tools.

## Mobile optimization and the uBlock Origin Lite section

The README includes a dedicated section on reducing filter overhead for mobile browsers. The recommended approach is to disable cosmetic filtering, which removes rules that hide elements on the page rather than blocking network requests. Cosmetic filters are more expensive to evaluate per page than network-request filters, and their benefit on mobile is lower because screen size makes some element-hiding less meaningful.

The README also lists optimized versions of some filter lists that contain a reduced rule count without the lowest-value rules. These are presented as alternatives for mobile users who need faster page loads.

For users of uBlock Origin Lite (the Manifest V3 version), the README notes that the default filtering mode must be set to Complete on sites with heavy ad injection, such as youtube.com. Without that setting, uBlock Origin Lite applies only basic blocking without the full rule set.

## Where yokoffing/filterlists falls short

The lists are tailored for uBlock Origin. The README states directly that it cannot guarantee filters will work in other ad blockers. The AdGuard and Brave import instructions are provided as a convenience, but the filter syntax used in some lists may not be compatible with all ad blocker engines.

The repository itself has no install step and no license file. The filter lists are plain text files with one rule per line following uBlock Origin's filter syntax. There is no versioning system within the repository beyond git history, so there is no way to pin a specific list version from a subscribe link.

The README's three-tier setup examples (Enhanced, Pro, Optimized) are guidance rather than configurations that can be imported as a single unit. Each list must be subscribed to individually.

EasyList and EasyPrivacy, the default lists that ship with uBlock Origin, are maintained by a large community of contributors and cover the broadest set of advertising and tracking domains. yokoffing/filterlists supplements those defaults with targeted additions rather than replacing them. Users who want a single comprehensive list without managing multiple subscriptions are better served by the defaults alone.

## Conclusion

yokoffing/filterlists is appropriate for uBlock Origin users who have already applied the default lists and want targeted coverage for specific gaps: tracker requests not in EasyPrivacy, click-to-load for embedded third-party players, or a cleaner YouTube experience. It is not appropriate as a first or only filter list, since it is designed to supplement rather than replace the default lists. The README explicitly notes it cannot guarantee filters will work in ad blockers other than uBlock Origin, so Brave and AdGuard users should treat the listed instructions as a best-effort import rather than a supported workflow.

## FAQ

### How do I add a filter list to uBlock Origin?

Click the subscribe link next to the list entry in the README. A new tab opens; click Subscribe in the top right corner, then close the tab. Repeat for each list you want to add.

### What is the best filter list for ad blocking?

The README recommends starting with uBlock Origin's default lists and adding from yokoffing/filterlists only to target specific gaps. Privacy Essentials covers advanced tracker blocking, the click2load list reduces third-party player loading, and youtube_clear_view targets YouTube-specific ads. The README advises against adding many lists at once due to diminishing returns.

### Does yokoffing/filterlists work with Brave's built-in shields?

The README provides import instructions for Brave but notes not to use the subscribe link. Instead, navigate to brave://adblock, find the raw URL of the filter file on GitHub, and paste it under Add custom filter lists. The README cannot guarantee that filters written for uBlock Origin syntax will behave identically in Brave's filtering engine.

## Sources

- [Issues](https://github.com/yokoffing/filterlists/issues)
- [README](https://github.com/yokoffing/filterlists/blob/main/README.md)
- [yokoffing/filterlists on GitHub](https://github.com/yokoffing/filterlists)

---

Hysen Labs editorial analysis, written from the project's own repository and release notes. Cite the canonical page: https://hysenlabs.com/projects/yokoffing-filterlists
