View on GitHub

LanikSJ uBO Filters

For AdBlock/AdBlock Plus, AdGuard and uBlock Origin

Download this project as a .zip file Download this project as a tar.gz file

🛡️ uBlock Origin Filters

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

📑 Table of Contents

🎯 Purpose
⚙️ Actions
📊 Coverage
📄 Lists
- 📄 Main Lists
- 📄 Supplemental Lists
🔧 Usage Instructions
❓ FAQ
🙌 Attributions
🐛 Bugs
📝 License
💰 Donate

🎯 Purpose

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

⚙️ Actions

📊 Coverage

📄 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

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

🪝 Pre-commit Hook

A pre-commit hook (.pre-commit-config.yaml) runs scripts/pre-commit-checksum-sort.sh on every staged file under filters/. It calls scripts/checksum-sort.sh on each file (sort + fop validation + headers + checksum) and re-stages the result, so your commit always contains the processed output.

Install (one time per clone):

brew install pre-commit   # or: pip install pre-commit
pre-commit install

Requires fop on your PATH (the hook fails with install hints otherwise):

brew install laniksj/tap/fop-rs   # or: ./scripts/install-fop.sh (Linux/CI)

Operate:

# Normal use — the hook runs automatically on commit when filters/*.txt change
git add filters/combined-filters.txt
git commit -m "chore(filters): update combined filters"

# Run the hook manually on all files (re-sorts/checksums everything)
pre-commit run --all-files

# Run it on specific files without committing
pre-commit run checksum-sort --files filters/combined-filters.txt

# Bypass the hook for a single commit (not recommended for filter changes)
git commit --no-verify -m "chore(filters): update combined filters"

Note: after the hook re-stages a processed file, git status may show it as both staged and unstaged — just review the diff and commit again. Avoid pre-commit run --all-files unless you intend to touch every filter list, as it rewrites the checksum/date headers of all files under filters/.

🛠️ 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.