๐Ÿ›ก๏ธ uBlock Origin Filters

June 17, 2026 ยท View on GitHub

GitHub Repo Size GitHub Code Size in Bytes GitHub Last Commit GitHub Commit Activity

๐Ÿ“‘ Table of Contents

๐ŸŽฏ Purpose

I got tired of losing my filters when I switched machines so I created this repo.

โš™๏ธ Actions

Admiral Domains Dead Domains Check Fanboy Social

๐Ÿ“Š Coverage

Codacy Badge codecov

๐Ÿ“„ Lists

๐Ÿ“„ Main Lists

If you'd like to use any of the filter lists in this repo click the bellow links for AdBlock / AdBlock Plus / AdGuard / uBlock Origin:

๐Ÿ“„ Supplemental Lists

Some of these are old lists or not working lists for archiving purposes:

๐Ÿ”ง Usage Instructions

This repository includes several scripts for managing and processing filter lists. Below are the usage instructions for the main tools.

๐Ÿ“ Filter Processing Scripts

checksum-sort.sh - Filter List Processing Tool

The checksum-sort.sh script processes filter lists using fop-cli to update date and checksum.

Basic Usage:

./scripts/checksum-sort.sh filters/combined-filters.txt

Features:

  • FOP Integration: Uses fop-cli for sorting and checksum generation
  • Cross-Platform Compatibility: Works on both Linux and macOS
  • Simple and Fast: Minimal processing with reliable results

๐Ÿ› ๏ธ Other Utility Scripts

Domain-Specific Processing Scripts

The repository includes several specialized scripts for processing different types of filter lists:

  • admiral-domains.sh: Process Admiral anti-adblock domains
  • combined-filters.sh: Generate combined filter lists
  • fanboy-social.sh: Process Fanboy social media filters
  • malware-domains.sh: Process malware domain lists
  • remove-lines.sh: Remove specific lines from filter lists

Additional Tools

  • fop-cli: Filter Orderer and Preener CLI tool for processing filter lists

๐Ÿ”„ Workflow Examples

Basic Filter Processing Workflow:

# Process and sort a filter list
./scripts/checksum-sort.sh filters/combined-filters.txt

โš ๏ธ Important Notes

  • All scripts use fop-cli for processing
  • UTF-8 encoding is supported for international filter lists
  • Cross-platform compatibility ensures consistent behavior on Linux and macOS

โ“ FAQ

Q: Will these filter lists support any other adblockers such as AdGuard etc?

A: Yes, some of these lists do work with AdGuard, but USE AT YOUR OWN RISK as they haven't been tested thoroughly yet.

๐Ÿ™Œ Attributions

Some scripts have been "borrowed" from Fanboy ยฉ๏ธ All rights reserved by the original authors.

๐Ÿ› Bugs

Please report any bugs or issues you find. Thanks!

๐Ÿ“ License

MIT License

Patreon